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进 团 队 协 作 。 第 一 部 分 介绍 如 何 创建 一 个 优秀 的 团队 、 如 何 构 建 工 作 流 等 。 第 二 部 分 从 实践 的 




















角度 学 习 Git 命令 。 第 三 部 分 介绍 如 何在 GitHub, Bitbucket 和 GitLab 平台 上 托管 项 目 。 
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Johannes Schindelin 序 





在 Git 面世 之 前 ，Linux 内 核 开 发 多 年 来 一 直 使 用 专 有 版 本 控制 系统 BitKeeper， 并 取得 了 
巨大 的 成 功 。 但 存在 一 个 问题 : 一些 Linux 开发 者 反对 使 用 专 有 性 质 的 版 本 控制 系统 ， 随 
即 开 始 了 漫长 的 口水 战 。 正 是 因为 这 场 冲 突 ， 授 权 给 Linux 开发 者 免费 使 用 的 BitKeeper 
许可 证 被 吊销 ， 于 是 Git 应 运 而 生 。Linus Torvalds 花 了 两 周 时 间 ， 放 下 了 Linux 的 工作 ， 
想 要 寻找 一 个 替代 BitKeeper 的 方案 。 由 于 没 能 找到 一 个 满意 的 替代 工具 ， 他 干脆 自己 写 
了 第 一 个 非常 原始 的 版 本 ， 也 就 是 我 们 现在 所 说 的 Git: 一 个 用 Unix 风格 编写 的 shell 脚 
本 拼接 起 来 的 小 程序 。 具 有 讽刺 意味 的 是 ，Git 的 分 布 式 是 使 用 rsync 实现 的 ， 而 这 个 工具 
的 作者 恰好 就 是 那个 将 BitKeeper 推 下 历史 舞台 的 Linux 开发 者 。 


就 我 个 人 而 言 ， 我 最 初 痴 迷 于 Git 简洁 的 数据 结构 ， 随 后 参与 了 Git 的 移植 工作 ， 后 来 又 
做 了 越 来 越 多 的 改进 ， 包 括 “ 交 互 式 变 基 ”( 抱 车 ,这 个 名 字 有 些 星 泡 ) 的 发 明 ， 以 及 最 
后 对 Git 的 Windows 移植 版 本 的 维护 。10 年 来 ， 不 论 是 作为 跨 学 科 项 目的 专职 程序 员 ， 还 
是 高 度 分 布 式 开源 项 目的 负责 人 ， 从 事 生 命 科学 研究 的 我 几乎 每 天 都 要 用 到 Git, 


在 巴黎 举行 的 庆祝 Git 十 周年 的 Git Merge 大 会 上 ， 我 第 一 次 见 到 了 Emma， 她 分 享 了 一 场 
AA “HAIE Git”(https://youtu.be/xYhHi8yK-Is) 的 激情 演讲 。 这 个 演讲 给 我 留 下 了 很 
深 的 印象 ， 它 展现 了 Emma 广泛 的 技能 以 及 在 教学 和 项 目 管理 中 的 丰富 经 验 。 


这 本 书 视角 独特 ， 它 强调 了 Git 如 何 能 够 促进 团队 协作 ， 让 我 收获 颇 丰 。 这 本 书 讲 的 是 那 
么 简单 明了 ， 而 多 年 来 ， 我 一 直 沉 溺 于 技术 细节 ， 教 授 Git 时 总 是 从 头 开 始 面面俱到 ， 这 
可 能 是 最 令 人 受挫 的 教学 方式 之 一 了 。 这 本 书 重点 介绍 工作 流 和 角色 之 间 的 沟通 ， 引 导读 
者 理解 实际 项 目 中 过 到 的 真实 需求 。 了 解 这 些 知识 后 ， 你 会 学 到 有 趣 的 部 分 : 如 何 使 用 
Git 来 支持 你 的 需求 。 
正如 Emma 的 演讲 一 样 ， 她 的 写作 风格 也 令 人 愉悦 ， 使 这 本 书 兼 具 教育 性 和 趣味 性 。 这 本 
书 给 我 的 日 常 工作 带 来 了 有 价值 的 见解 。 不 论 你 在 日 常 工作 中 担任 什么 角色 ， 本 书 都 不 仅 
仅 是 一 本 手册 。 无 论 是 探索 团队 协作 的 不 同方 式 ， 还 是 探索 现代 版 本 控制 系统 帮助 推进 项 
目的 方法 ， 就 让 这 本 书 来 激发 你 释放 Git 的 全 部 潜能 ， 为 你 的 工作 提供 支持 吧 。 
Johannes Schindelin 博士 
Windows 3& Git 维护 者 
2015 年 8 月 于 德国 科隆 市 
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Mark Atwood FE 


版 本 控制 的 重要 性 怎么 强调 都 不 为 过 。 


我 认为 它 的 重要 性 不 亚 于 黑板 和 书本 的 发 明 ， 因 为 它 将 众人 的 力量 聚集 在 一 起 ， 从 而 创造 
了 更 大 的 价值 。 


在 我 的 职业 生涯 中 ， 我 看 到 在 软件 开发 中 ， 版 本 控制 系统 从 最 初 遭 到 抵触 到 现在 遍地 开 
花 ， 也 看 到 基础 技术 带 来 的 大 跃进 ， 其 中 每 一 次 飞跃 都 提升 了 我 们 创造 的 工作 价值 ， 加 快 
了 创造 的 速度 。 我 们 正在 以 更 快 的 速度 ， 和 更 多 的 人 一 起 ， 完 成 更 多 的 工作 。 


Git 带 来 的 最 近 一 次 飞跃 ， 对 我 们 的 工作 流 几乎 没有 作出 任何 限制 。 因 此 ， 我 们 需要 探索 
和 分 享 适合 自己 及 团队 的 工作 流 ， 而 不 是 使 用 以 往 为 机 器 设计 的 难 用 的 工作 流 。 这 本 书 介 
绍 了 其 中 一 些 工作 流 。 我 相信 你 在 未 来 会 遇 到 更 多 的 工作 流 。 

教育 的 重要 性 和 难度 也 不 言 而 喻 。 所 谓 的 教育 不 只 是 简单 地 死记 硬 青 或 反复 训练 ， 而 是 更 
深入 的 教化 : 如 何以 特定 方式 思考 ， 理 解 为 何 要 如 此 思考 ， 以 及 如 何 告诉 别人 你 的 想法 。 
正确 地 使 用 版 本 控制 系统 就 是 一 种 思考 方式 ,用 精益 求 精 的 软件 开发 所 要 求 的 深度 和 严 说 
来 建 模 、 记 忆 、 交 流 。 如 果 没 有 那样 的 理解 ，Git 不 过 是 使 用 一 些 死记 硬 青 、 充 满 未 知 危 
险 的 “神奇 咒语 ">。 有 了 那样 的 理解 ，Git 会 变 得 几乎 无 法 察觉 ， 留 给 你 复杂 的 命令 背后 的 
模式 ， 也 就 是 软件 的 魔力 根源 。 

这 本 书 会 帮助 你 提升 自己 对 Git 的 理解 ， 并 学 以 臻 用。 

































































Mark Atwood 
惠普 公司 开源 主管 
2015 年 8 月 于 华盛顿 州 西雅图 市 
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献 给 Joe Shindelar, 33A! 
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在 将 近 二 十 年 里 ， 我 在 个 人 和 团队 开发 中 或 多 或 少 都 采用 了 分 布 式 的 工作 方式 。 我 的 第 一 
份 有 报酬 的 Web 开发 工作 是 在 20 世纪 90 年 代 中 期 。 那 时 ， 我 维护 文件 版 本 的 方式 只 是 
通过 修改 文件 名 来 标记 一 个 新 的 版 本 。 我 的 工作 区 堆 满 了 这 些 文件 ， 它 们 的 扩展 名 很 不 寻 
常 ， 像 v4.old-er.bak 这 样 的 名 称 到 处 都 是 。 记 录 我 的 工作 可 不 是 件 容易 的 事情 。 在 一 个 对 
我 来 说 很 有 挑战 的 项 目 中 ， 我 不 得 不 用 上 了 之 前 修改 论文 时 的 方法 : 把 要 修改 的 Perl 脚 
本 打印 出 来 ， 将 这 些 纸 装 到 活页 夹 里 ， 然 后 在 脚本 上 用 不 同 颜色 的 笔 做 记号 ， 最 后 把 改动 
转录 回 文本 编辑 器 。( 要 是 有 照片 可 以 分 享 就 好 了 。) 我 通过 翻阅 活页 夹 来 找到 之 前 的 脚 
本 ， 从 而 记录 版 本 。 我 完全 不 知道 该 如 何 搭 建 一 个 真正 的 版 本 控制 系统 (version control 
system，VCS)， 而 仅仅 执着 于 让 正确 的 内 容 不 会 因为 重 构 失败 而 丢失 。 


当 开 始 和 其 他 开发 者 一 起 工作 时 ， 不 管 是 做 开源 项 目 还 是 客户 的 项 目 ， 我 都 不 是 第 一 

加 入 的 开发 者 。 在 我 加 入 时 总 JDA DECEM, NEER ARSA 
(concurrent versions system, CVS). 是 最 易 用 的 系统 ， 但 和 我 写 满 了 改动 的 活页 夹 比 
起 来 ， | 
起 来 ， 并 珍视 这 种 能 够 审阅 其 他 同事 的 工作 的 便利 性 。 它 促使 我 观察 其 他 人 提交 到 仓库 中 
的 代码 。 我 可 不 想 让 他 们 认为 我 在 偷懒 ! 


与 此 同时 ， 我 在 几 个 不 同 的 社区 大 学 里 教授 Web 开发 。2004 年 在 汉 博 学 院 由 Bernie 
Monette 设计 的 一 个 为 期 一 年 的 项 目 中 ， 我 第 一 次 有 机 会 教授 版 本 控制 。 整 个 班级 被 分 成 
了 几 组 。 在 第 一 个 学 期 中 ， 学 生 草拟 了 一 个 网 站 开发 计划 。 在 第 二 个 学 期 中 ， 团 队 被 打 乱 
了 ， 新 的 团队 被 要 求 构建 上 一 个 团队 所 描述 的 网 站 。 在 第 三 个 也 是 最 后 一 个 学 期 中 ,分 组 
被 再 次 打 乱 ， 最 终 的 任务 是 对 建 好 的 网 站 进行 bug 修复 和 质量 保证 。 每 个 团队 都 被 强制 要 
求 使 用 版 本 管理 来 记录 他 们 的 工作 。 这 些 先 前 没有 编程 经 验 的 学 生 并 没有 对 使 用 版 本 控制 
感到 兴奋 ， 反 而 觉得 这 妨碍 了 他 们 的 工作 。 但 事情 也 变 得 更 简单 了 ， 因 为 他 们 从 来 都 没有 
意外 地 覆盖 其 他 同学 的 工作 。 这 件 事 在 很 大 程度 上 教育 了 我 ， 使 我 知道 如 果 一 个 工具 看 上 
去 并 非 必 需 ， 应 该 如 何 激 励 人 们 去 使 用 它 。 


在 那 门 课 后 的 十 年 里 ， 我 学 到 了 很 多 版 本 控制 的 教学 方法 ， 以 及 在 成 人 教育 中 获得 的 最 佳 
实践 。 这 本 书 正 是 我 学 到 的 精华 ， 讲 述 通过 版 本 控制 进行 有 效 协 作 的 方法 。 在 整 本 书 中 ， 
我 都 鼓励 你 因地制宜 。 不 会 有 “Git 警察 ”突然 出 现 ， 告 诉 你 “你 做 错 了 。 也 就 是 说 ， 我 



















































































Jg 































































































xiii 


会 尽 我 所 能 地 告诉 你 “Git 风格 ”的 工作 方式 ， 当 你 想 要 开始 在 团队 中 实践 ， 或 是 获得 自 
我 提升 时 ， 给 你 一 些 指导 。 使 用 “通行 ”的 工作 方式 有 助 于 你 和 其 他 之 前 使 用 过 类 似 技术 
的 人 找到 共同 语言 。 

这 本 书 不 是 写 给 所 有 人 的 ， 而 是 写 给 那些 热爱 提前 计划 ， 然 后 遵循 明确 线路 的 人 。 我 希 
望 本 书 至 少 有 助 于 弥补 当前 Git 资料 中 的 空缺 。 与 其 说 这 是 一 本 软件 指南 ， 不 如 说 它 是 一 
本 团队 协作 指南 。 如 果 你 的 团队 觉得 书 中 内 容 有 困惑 之 处 ， 我 希望 你 能 够 发 送 电子 邮件 至 
emma@gitforteams.com 来 告诉 我 ， 如 果 你 觉得 它 有 用 的 话 ， 我 希望 你 能 让 全 世界 都 知道 。 


致谢 

儿 年 前 ， 在 布拉格 一 个 慕 地 边 上 的 小 酒馆 里 ， 我 各 Carl. Wiedemann 请 教 了 很 多 关于 Git 的 
问题 。 谢 谢 你 ，Carl。 你 的 热情 激励 我 化 挫折 为 动力 ， 避 免 别人 重复 我 在 学 习 Git 时 所 走 
过 的 弯路 。 

和 Joe Shindelar 一 起 工作 的 时 光 是 我 宝贵 的 财富 ， 那 是 我 在 十 年 的 自由 职业 之 后 的 第 一 份 
工作 。Joe， 你 对 卓越 的 追求 提高 了 我 在 工作 上 的 自我 要 求 。 我 很 感激 你 的 耐心 和 领导 。 这 
本 书 起 源 于 我 们 关于 领导 力 和 团队 结构 的 谈话 ， 以 及 我 们 为 Drupalize.Me 团队 创建 的 Git 
文档 。 谢 谢 你 。 

O'Reilly 找到 了 杰出 的 Christophe Portneuve 作为 我 的 技术 审 稿 人 之 一 。Christophe， 谢 谢 你 
在 我 编写 前 几 章 时 的 耐心 。 你 的 反馈 是 非常 宝贵 的 。 我 很 感谢 我 们 在 Git Merge 大 会 上 的 
讨论 ， 这 场 对 话 帮助 我 厘清 了 书 中 用 到 的 概念 ， 这 让 我 有 一 个 崇高 的 目标 ， 那 就 是 转变 人 
们 学 习 Git 的 方式 。 我 希望 你 参与 的 这 本 书 会 让 你 引 以 为 荣 。 

Bernie Monette, Martin Poole 和 Drew McLelland: 你 们 为 我 提供 了 一 个 平台 ， 让 我 通过 你 
们 的 项 目 来 完善 我 对 版 本 控制 的 理解 。 

Lorna Jane Mitchell， 感 谢 你 不 人 冬 的 鼓励 。 谢 谢 你 和 我 分 享 你 自己 的 Git 工作 。 这 激励 着 我 
要 对 自己 提出 更 高 的 要 求 。 

推动 我 完成 本 书 的 “燃料 ”来 自 200 Degrees Coffee, 一 家 诺丁汉 郡 的 烘焙 坊 。 我 首选 的 饮 
料 是 这 家 烘焙 坊 或 者 司法 博物 馆 画 廊 前 的 Divine Coffee HERRIA H. Hiit 200 Degrees 
Coffee 和 Divine Coffee 为 我 提供 了 休 总 的 去 处 ， 让 我 想 待 多 久 就 可 以 待 多 入。 
致 O'Reilly 大 家 庭 : 你 们 对 我 所 有 的 请 求 (以 及 错过 的 截稿 期 限 ) 都 处 理 得 非常 棒 。 谢 
谢 Rachel、Heather、Robert、Colleen、Brian、Josh、Rebecca、Kim， 还 有 数 不 清 的 幕后 英 
雄 ， 是 你 们 让 这 本 书 的 出 版 成 为 了 现实 。 

致 Git 核心 社区 : 谢谢 你 们 邀请 我 参加 2015 年 的 Git Merge 大 会 。 你 们 接纳 了 我 在 台 上 关 
于 探索 Git 教学 新 方法 的 激烈 演说 。 你 们 真心 听取 了 我 的 建议 ， 然 后 改进 了 Git 的 使 用 体 
验 。 我 期 待 在 这 个 优秀 的 社区 里 参加 更 多 活动 ， 这 里 有 你 们 一 直 以 来 默默 的 奉献 。 

我 也 要 感谢 我 的 审 稿 人 : Diane Tani、Novella Chiechi、Amy Brown、Blake Winton、Stuart 
Langridge, Stewart Russell, Dave Hammond, John Wynstra, Chris Tankersley, Mike 


































































































Anello, Piotr Sipika, Nancy Deschenes, Robert Day, Dave Hammond, Sebastien Simard, 





Tobias Hiep, Nick Gard, Christopher Maneu, Johannes Schindelin, Edward Thomson, 
mattj. sorenson, Douwe Maan, Sytse Sijbrandij, Rob Allen, Steven Pears, Laura Lemay, 


你 们 的 反馈 非常 宝贵 。 
致 我 的 伴侣 James Westby: 感谢 你 耐心 地 等 待 我 完成 “最 后 一 件 
和 鼓励 ， 这 本 书 也 就 不 会 面世 了 。 


lin. 





E. HEP TT 























a 
Tip 





= 
nit 


本 书 采用 以 人 为 本 的 方式 讲解 版 本 控制 。 我 不 想 从 Git 的 历史 讲 起 ， 而 是 在 一 开始 先 概览 
各 式 各 样 的 团队 协作 方法 。 接 下来， 我们 会 绕 回 到 Git 命令 ， 确 保 你 在 襄 下 命令 键 时 总 是 
知道 为 什么 。 通 过 使 用 特定 的 工作 流 ， 有 时 你 可 以 市 省 自己 未 来 的 时 间 (并 减少 困惑 )。 
这 些 说 明 会 给 你 一 个 宏观 的 理解 ， 告 诉 你 当下 的 工作 是 如 何 影 响 到 未 来 的 工作 的 ， 也 希望 
你 能 清楚 为 什么 有 些 人 如 此 执着 于 他 们 的 Git 方 法 论 。 

第 一 部 分 主要 面向 管理 者 、 技 术 团 队 的 负责 人 、 首 席 技术 官 、 项 目 经 理 ， 以 及 需要 制定 团 
队 工 作 流 的 技术 型 项 目 经 理 。 


优秀 的 技术 源 自 优秀 的 团队 。 在 第 1 章 中 ， 你 会 了 解 为 什么 要 创建 一 个 优秀 团队 。 学 完 这 
一 章 ， 你 将 能 分 清 团 队 中 的 所 有 和 角色， 组 织 富 有 成 效 的 会 议 ， 通 过 关键 词 识别 出 和 团队 脱 
市 的 成 员 ， 并 使 用 策略 来 培养 团队 成 员 间 的 认同 和 信任 。 

尽早 为 项 目 设 定 预期 。 在 第 2 章 中 ， 你 会 学 到 用 于 允许 和 拒绝 访问 Git 仓库 的 不 同 权限 策 
略 。 是 否 应 该 允许 团队 成 员 跳 过 评审 直接 将 工作 存 至 仓库 ? 这 是 不 是 更 像 一 个 信任 和 被 信 
任 的 问题 ?这 两 种 方法 各 有 其 优点 ， 这 一 章 将 详细 介绍 它们 。 

带 着 清晰 的 目标 工作 。 在 Git 中 ， 你 将 会 使 用 分 支 来 分 离 不 同 的 工作 。 第 3 章 向 你 展示 如 
何 使 用 分 支 来 隔离 团队 中 运用 的 不 同 构想 。 当 然 ， 你 还 需要 知道 如 何 将 分 散 的 工作 拼 成 一 
个 完整 的 软件 。 这 一 章 介绍 了 一 些 常 见 的 分 支 策略 ， 其 中 包括 GitFlow, 


记录 有 助 于 日 后 工作 的 文档 。 第 4 章 是 第 一 部 分 中 所 有 概念 的 汇总 。 你 会 学 到 如 何 创建 自 
己 的 文档 ， 并 浏览 一 个 简单 的 软件 产品 的 创建 和 部 署 的 全 过 程 。 

第 二 部 分 主要 面向 开发 者 。 在 这 一 部 分 中 ， 你 将 会 学 到 Git 命令 究竟 是 如 何 工作 的 (终于 
讲 到 这 儿 了 )。 如 果 你 很 着 急 ， 希 望 立刻 开始 编写 代码 ， 只 需要 从 第 二 部 分 开始 看 起 ， 看 
完 之 后 再 回 到 第 一 部 分 。 

用 实战 技能 武装 自己 。 第 5 章 介绍 分 布 式 版 本 控制 的 所 有 基础 概念 。 在 这 一 章 中 你 会 学 到 
如 何 创建 仓库 ， 以 及 通过 提交 、 分 支 和 标签 在 本 地 记录 你 对 文件 的 更 改 。 

学 会 从 错误 中 恢复 。 第 6 章 讲解 如 何 浏览 历史 版 本 ， 包 括 如 何 修复 提交 、 从 时 间 线 上 移 除 
























































































































































xvii 


提交 以 及 变 基 。 

和 团队 成 员 协 同 工 作 。 现 在 你 已 经 对 浏览 自己 的 仓库 的 历史 游 力 有余， 是 时 候 和 别人 一 起 
协作 了 。 第 7 章 将 告诉 你 如 何 跟踪 远 端 更 改 ， 将 代码 上 传 至 一 个 共享 仓库 ， 并 将 其 他 成 员 
的 更 新 同步 到 你 的 本 地 仓库 。 
通过 同行 评审 ， 分 享 出 色 完 成 工作 时 的 荣 沟 和 责任 。 在 第 8 章 中 ， 你 将 会 学 习 在 团队 中 实 
践 代码 评审 的 流程 。 我 们 还 会 讲 到 在 常见 的 评审 方法 中 使 用 的 命令 ， 以 及 为 自己 的 团队 定 
制 时 的 一 些 建议 。 

探索 项 目 历史 ， 寻 求 问题 解决 之 道 。 在 第 9 章 中 ， 你 将 学 会 用 一 些 高 级 的 Git 方 法 来 跟踪 
bug。 不 过 ， 不 要 害怕 ! 这 些 命令 不 会 比 之 前 的 命令 更 难 学 。 

第 三 部 分 是 最 后 一 部 分 ， 介 绍 一 些 市 面 上 流行 的 代码 托管 系统 。 这 部 分 内 容 既 适合 管理 者 
也 适合 开发 者 。 

通过 开放 的 协作 促进 社区 的 成 长 。 第 10 章 讲解 在 GitHub 上 建立 和 维护 一 个 开源 项 目的 方 
法 。 

想 要 编写 优良 的 代码 ， 团 队 必 须 拥有 自己 的 仓库 。 在 第 11 章 中 ， 你 将 学 习 如 何在 私有 仓 
库 中 协作 。 这 一 章 尤 其 适用 于 那些 希望 建立 私有 仓库 ， 但 没有 充足 资金 购买 GitHub 上 私 
有 仓库 的 团队 。 

良好 的 约束 可 以 营造 更 好 的 氛围 。 在 第 12 章 中 ， 你 将 学 习 如 何 托 管 你 自己 的 GitLab 实例 ， 
并 在 上 面 运行 项 目 。 这 对 于 防火 墙 内 无 法 接触 到 公共 互联 网 的 开发 者 来 说 尤为 有 用 。 

本 书 不 是 面向 所 有 人 的 。 对 于 喜欢 自己 折腾 和 探索 的 读者 来 说 ， 阅 读本 书 未 免 会 感到 广 
下。 反之 ， 本 书 适 合 有 些 畏 惧 未 知事 物 的 读者 。 

补充 资料 和 更 清晰 的 流程 图 可 以 在 本 书 的 官方 网 站 (http://gitforteams.com/) 上 找到 。 


排版 约定 

本 书 使 用 了 下 列 排版 约定 。 

。 楷体 
表示 新 术语 或 重点 强调 的 内 容 。 

。 等 宽 字 体 (constant width) 
表示 程序 片段 ， 以 及 正文 中 出 现 的 变量 、 函 数 名 、 数 据 库 、 数 据 类 型 、 环 境 变 量 、 语 句 
和 关键 字 等 。 


。 加 粗 等 宽 字 体 (constant width bold) 
表示 应 该 由 用 户 输入 的 命令 或 其 他 文本 。 
。 等 宽 斜 体 (constant width italic) 
表示 应 该 由 用 户 输入 的 值 或 根据 上 下 文 确定 的 值 替 换 的 文本 。 
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该 图 标 表示 提示 或 建议 。 


该 图 标 表示 一 般 注 记 。 





该 图 标 表示 警告 或 警示 。 


代码 用 例 


本 书 的 补充 资料 (示例 代码 、 练 习 等 ) 可 以 从 网 站 http://gitforteams.com 下 载 。 


本 书 是 为 了 帮 你 做 好 工作 。 一 般 来 说 ， 你 可 以 在 程序 和 文档 中 使 用 本 书 的 代码 。 除 非 你 使 
用 了 很 大 一 部 分 代码 ， 否 则 无 需 联系 我 们 获得 许可 。 例 如 ， 使 用 本 书 的 几 段 代码 写 一 个 程 
序 是 不 需要 许可 的 。 销 售 或 分 发 O'Reilly 书 中 示例 的 光盘 (CD-ROM) 是 需要 许可 的 。 通 
过 引用 本 书 和 示例 代码 来 回答 问题 是 不 需要 许可 的 。 把 本 书 中 大 量 的 示例 代码 并 入 到 你 的 
产品 文档 中 是 需要 许可 的 。 

我 们 赞赏 但 不 强制 要 求 注 明 信 息 来 源 。 信 息 来 源 通 常 包括 书 名 、 作 者 和 国际 标准 书号 
(ISBN), 例 如 :“Git for Teams by Emma Jane Hogbin Westby (O'Reilly). Copyright 2015 
Emma Jane Hogbin Westby, 978-1-491-91118-1." 


如 果 你 觉得 对 示例 代码 的 使 用 超出 了 正当 引用 或 这 里 给 出 的 许可 范围 ， 请 随时 发 送 电子 邮 
件 到 permissions@oreilly.com， 与 联系 我 们 。 














Safari? Books Online 


." Safari Books Online (http;//safaribooksonline.com/) 是 应 运 而 生 的 数 
Safa 门神 图 书馆 。 它 同时 以 图 书 和 视频 的 形式 出 版 世界 顶级 技术 和 商务 
作家 的 专业 作品 (https:/www.safaribooksonline.com/explore/)。 
技术 专家 、 软 件 开发 人 员 、Web 设计 师 、 商 务 人 士 和 创意 专家 等 ， 在 开展 调研 、 解 决 问 
题 、 学 习 和 认证 培训 时 ， 都 将 Safari Books Online 视 作 获取 资料 的 首选 渠道 。 
Safari Books Online 为 企 业 (https://www.safaribooksonline.com/enterprise/), 政府 机 构 
(https:/www.safaribooksonline.com/government/)、 教 育 机 构 (https://www.safaribooksonline. 
com/academic-public-library/) 和 个 人 读者 提供 了 一 系列 的 产品 组 合 和 价格 体系 (https:// 
www.safaribooksonline.com/pricing/) 。 




















会 员 可 在 一 个 支持 完全 搜索 的 数据 库 中 访问 数 以 千 计 的 图 书 、 培 训 视 频 和 尚未 发 行 的 
书稿 。 发 行 这 些 内 容 的 是 O'Reilly Media, Prentice Hall Professional, Addison-Wesley 
Professional, Microsoft Press, Sams, Que, Peachpit Press, Focal Press, Cisco Press, John 
Wiley & Sons, Syngress, Morgan Kaufmann, IBM Redbooks, Packt, Adobe Press, FT 
Press, Apress, Manning, New Riders, McGraw-Hill, Jones & Bartlett, Course Technology 
以 及 其 他 数 百 家 发 行商 (https://www.safaribooksonline.com/our-library/), 97H T ffff Safari 
Books Online 的 更 多 信息 ， 请 访问 我 们 的 网 站 (http://www.safaribooksonline.com/)。 


联系 我 们 
请 把 对 本 书 的 评价 和 问题 发 给 出 版 社 。 
美国 ， 

O'Reilly Media, Inc. 


1005 Gravenstein Highway North 
Sebastopol, CA 95472 


中 国 : 
北京 市 西城 区 西直门 南大 街 2 号 成 铭 大 厦 C 座 807 (100035) 
奥 菜 利 技术 咨询 (北京) ARAE 


O'Reilly 的 每 一 本 书 都 有 专属 网 页 , 你 可 以 在 那儿 找到 本 书 的 相关 信息 ,包括 勘误 表 '、 示 例 
代码 以 及 其 他 信息 。 本 书 的 网 站 地 址 是 : http://shop.oreilly.com/product/0636920034520.do 


对 于 本 书 的 评论 和 技术 性 问题 ， 请 发 送 电 子 邮件 到 : bookquestions@oreilly.com 
要 了 解 更 多 O'Reilly 图 书 、 培 训 课程 、 会 议和 新 闻 的 信息 ， 请 访问 以 下 网 站 ; 


http://www.oreilly.com 
我 们 在 Facebook 的 地 址 如 下 : http://facebook.com/oreilly 
请 关注 我 们 的 Twitter 动态 : http://twitter.com/oreillymedia 



































我 们 的 YouTube 视频 地 址 如 下 : http:/www.youtube.com/oreillymedia 


EFE 


扫描 如 下 二 维 码 ， 即 可 购买 本 书 电 子 版 。 

















注 1: 本 书 中 文 版 的 勘误 ， 可 到 http://www.ituring.com.cn/book/1779 查看 和 提交 。 一 一 编者 注 
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第 一 部 分 





刚 开 始 教授 编程 时 ， 我 们 





宏观 视角 展开 ， 讲 述 以 不 同方 式 组 织 工作 流 将 会 如 何 影响 


制定 工作 流 


常常 会 编写 一 个 简单 的 小 程序 ， 来 演示 一 组 特定 命令 的 输出 。 成 
人 学 习 者 常常 会 想 “ 这 有 什么 用 呢 ”， 他 们 不 知道 如 何 将 这 些 命令 用 于 实际 场景 。 








本 书 从 
si 作 方 式 。 如 果 你 倾向 于 用 





命令 思考 ， 请 跳 过 这 个 部 分 ， 从 第 二 部 分 读 起 。 然 后 ， 当 你 开始 问 自 己 “ 这 有 什么 用 ”的 
时 候 ， 再 回 到 这 部 分 ， 就 能 明白 基于 Git 的 日 常 工作 会 如 何 影响 未 来 的 协作 。 





这 一 部 分 对 于 那些 监督 工作 是 如 何 完 成 的 读者 来 说 最 有 用 。 
中 可 能 包括 技术 团队 的 负责 














、 首 席 技 术 官 、 


H 





这 些 人 大 多 担任 管理 角色 ， 其 
经 理 、 项 目 经 理 以 及 技术 型 项 目 经 理 。 


第 1 章 


团队 作战 

















我 教授 版 本 控制 已 经 超过 十 年 了 。 参 加 我 的 现场 研讨 会 的 大 部 分 人 都 疫 于 处 理 办 公 室 政治 
问题 ， 而 不 是 技术 问题 。 当 然 ， 这 些 问 题 不 尽 相 同 。 或 许 他 们 苦于 让 同事 明白 版 本 控制 有 
多 么 重要 ， 或 许 他 们 想 要 明确 责任 关系 ， 又 或 许 他 们 被 团队 选 出 来 去 搞 清楚 团队 工作 流 中 
的 乱 象 。 不 管 是 什么 问题 ， 先 理解 并 解决 背后 的 人 际 关系 问题 可 以 使 Git 的 学 习 和 使 用 更 
加 容易 。 

完成 本 章 学 习 之 后 ， 你 将 具备 以 下 技能 。 

。 识别 一 个 完整 团队 中 的 各 个 角色 

。 组 织 一 个 富有 成 效 的 会 议 
。 通过 关键 词 识别 与 你 的 团队 脱 市 的 成 员 

。 使 用 策略 来 培养 团队 成 员 彼 此 间 的 认同 和 信任 

在 开始 前 ， 你 必须 理解 你 的 团队 以 及 软件 需求 。 如 果 一 开始 团队 就 充满 了 信任 和 彼此 关 
爱 ， 当 你 计划 用 Git 命令 来 达成 目标 时 ， 将 会 发 现 自己 一 身 轻松 。 在 充满 信任 的 团队 里 ， 
当 有 人 遇 到 困难 时 ， 你 们 可 以 互相 帮助 ， 人 们 在 需要 帮助 时 也 会 更 加 坦诚 。 当 人 们 感受 到 
支持 ， 并 理解 为 什么 要 用 这 些 Git 命令 时 ， 他 们 会 更 可 能 让 Git 为 他 们 所 用 ， 而 不 是 死记 
硬 背 儿 个 命令 ,祈祷 自己 用 对 了 。 


1.1 团队 成 员 


在 小 团队 中 ， 可 能 一 个 人 就 承担 了 很 多 角色 。 紧 跟 小 团队 中 每 个 人 的 日 常 工作 相对 容易 。 
然而 ， 在 大 团队 中 ， 角 色 可 能 分 散在 不 同 部 门 。 那 些 对 代码 库 进 行 用户 验 收 测 试 的 团队 ， 
可 能 从 来 没有 和 被 测试 产品 的 设计 师 和 开发 者 说 过 话 。 两 种 团队 都 可 能 遇 到 问题 ， 如 果 没 
有 足够 的 背景 知识 ， 却 被 提出 了 更 高 的 要 求 ， 最 后 注定 会 有 所 遗漏 ， 团 队 之 间 人 为 的 屏障 




























































































总 是 会 增加 他 们 之 间 的 紧张 关系 。 在 开发 代码 时 ， 这 样 的 隔 疼 可 不 是 什么 好 事 。 


你 是 否 听 说 过 “以 终 为 始 ” 这 人 句 话 ? 当 我 构建 软件 时 ， 总 是 在 替 别 人 构建 。 即 使 我 拼命 回 
忆 ， 也 想 不 起 来 自己 曾经 出 于 自 娱 自 乐 的 目的 开发 过 某 个 产品 。 我 不 是 天 生 的 黑客 。 我 被 
软件 吸引 ， 是 因为 它 能 带 给 别人 价值 。 每 次 我 坐 下 来 解决 一 个 问题 时 ， 想 的 都 是 给 用 户 提 
供 更 好 的 体验 。 我 希望 避免 反复 ， 也 希望 保护 用 户 的 安全 。 我 希望 他 们 感觉 到 自己 心灵 手 
巧 ， 而 非 策 抄 。 如 果 在 我 和 用 户 之 间 还 隔 了 客户 ， 我 有 时 还 需要 改变 客户 思考 问题 的 方 
式 ， 以 便 满足 他 们 的 商业 目标 ， 同 时 保证 终端 用 户 的 良好 体验 。 每 当 我 们 坐 下 来 工作 时 ， 
应 该 从 描述 希望 为 用 户 解决 的 问题 开始 ， 也 就 是 从 用 户 故 事 (user story) 开始 。 

接 下 来 ， 在 测试 驱动 开发 流程 中 ， 你 将 会 编写 验收 测试 ， 界 定 如 何 知道 问题 已 被 解决 。 声 
明 会 依据 编写 用 途 被 自动 化 测试 套件 、 质 量 保 证 (QA) 团队 或 是 同行 评审 员 使 用 。 如 果 
提前 与 测试 团队 商定 验收 测试 ， 那 么 开发 者 会 更 清楚 工作 的 产 出 应 该 是 什么 样 的 。 一 般 来 
说 ， 测 试 应 该 描述 需要 解决 的 问题 ， 而 不 是 规定 将 要 使 用 的 技术 。 


测试 流程 应 该 包含 安全 性 评审 。 规 模 更 大 的 公司 有 幸 拥 有 专门 的 安全 专家 。 让 这 些 专家 尽 
早 介 入 这 个 流程 ， 请 他 们 教 你 如 何 编写 安全 的 代码 。 如 果 你 的 QA、 安 全 和 开发 团队 是 分 
散 的 ， 在 一 开始 将 他 们 聚 在 一 起 ， 这 会 使 测试 流程 变 得 更 加 有 趣 ， 因 为 开发 者 力图 提供 完 
美的 代码 ， 而 测试 团队 力图 挑刺 。 


如 果 部 署 不 由 你 负责 ， 同样 让 运 维 团队 尽早 介入 。 保 证 你 的 开发 环境 和 最 终 的 产品 环境 越 
接近 越 好 。 理 想 情况 下 ， 你 应 该 使 用 构建 脚本 (build script) 来 尽 可 能 自动 复制 环境 。 你 
可 以 选择 使 用 Docker (http//www.docker.com/) 和 Vagrant (http://vagrantup.com/) 来 创建 
环境 副本 。 和 运 维 团队 一 起 ， 使 用 诸如 Chef (https://www.chef.io/chef/), Puppet (https:// 
puppetlabs.com/) 或 Ansible (http://www.ansible.com/home) 这 样 的 工具 创建 管理 配置 文件 
的 基础 设施 。 


讲 到 开发 的 技术 栈 ， 如 果 你 在 使 用 开源 软件 ， 请 了 解 一 下 你 将 要 使 用 的 产品 的 开发 社区 。 
我 们 很 少 遇 到 新 的 问题 ， 而 有 的 人 可 能 已 经 遇 到 过 你 的 问题 。 在 代码 社区 中 寻找 导师 ， 同 
时 指导 别人 。 打 破 团队 的 边界 ， 走 出 办 公 室 ， 可 怕 的 问题 会 变 得 简单 得 多 。 


当 促 进 大 公司 中 部 门 间 的 协作 时 ， 可 以 减少 代码 在 原 地 闲置 的 时 间 。 朵 置 的 代码 会 以 各 种 
方式 耗费 你 的 金钱 : 新 特性 的 代码 可 能 阻碍 你 赚 更 多 的 钱 ， 修复 bug 的 代码 则 可 能 阻碍 你 
停止 损失 。 闲 置 的 代码 慢 慢 就 不 新 鲜 了 。 代 码 等 待 评审 的 时 间 越 长 ， 它 可 能 偏离 你 的 主 分 
支 越 远 。 它 偏离 得 越 远 ， 同 步 并 预 发 这 些 工 作 就 越 麻烦 。 

最 后 ， 我 们 会 审视 自己 的 团队 。 技 术 架 构 师 负责 规划 解决 方案 应 该 如 何 实施 。 架 构 的 决策 
应 该 有 文档 记录 并 尽 可 能 共享 。 架构 师 可 能 也 是 编码 团队 的 一 员 。 编 码 团队 可 能 由 前 端 开 
发 者 、 后 端 开 发 者 、 设 计 师 和 项 目 经 理 组 成 。 我 有 时 候 也 和 商业 分 析 师 一 起 工作 。 如 果 你 
在 敏捷 开发 环境 中 工作 ， 可 能 还 需要 一 个 敏捷 专家 和 一 个 产品 负责 人 。 


我 倾向 于 在 这 样 的 环境 中 工作 : 无 论 哪 里 有 需要 ， 每 个 人 都 愿意 伸 出 援手 。 自 我 管理 的 团 
队 通 常 彼此 非常 信任 和 尊重 。 不 过 ， 这 种 状态 是 需要 你 努力 构建 的 。 共 识 驱 动 的 开发 最 适 
合 小 规模 的 内 部 项 目 ， 但 这 并 不 意味 着 你 不 能 在 其 他 地 方 尝试 协作 。 管 理 项 目 时 ， 我 喜欢 
让 开发 者 选择 他 们 想 做 的 工 单 。 这 增加 了 他 们 的 自主 性 ， 如 果 需 要 ， 让 开发 者 从 任务 中 解 
脱 片 刻 。 不 过 ， 我 也 发 现 有 些 人 喜欢 别人 替 他 们 分 配 好 工 单 。 
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没有 一 种 方式 可 以 组 织 所 有 团队 或 管理 所 有 项 目 。 一 个 充满 斗志 和 凝聚 力 的 团队 ， 其 秘诀 
是 尊重 团队 中 的 每 个 人 ， 只 要 有 可 能 ， 就 根据 他 们 的 喜好 来 改善 流程 。 


12 思维 策略 


团队 中 的 每 个 人 都 有 自己 的 工作 习惯 ,不 同 的 工作 方式 适用 于 不 同 的 场景 。 没 有 一 种 所 谓 
正确 的 做 事 方法 。 如 果 你 能 共享 每 个 人 高 效 产 出 的 策略 ， 拥 抱 差 异 ， 将 会 使 你 的 团队 更 加 
强大 。 我 知道 我 总 是 在 寻找 更 高 效 地 工作 的 小 窍门 ， 我 渴望 能 了 解 让 人 们 愿意 全 身心 投入 
一 件 事 的 原因 。 


几 年 前 ， 我 兽 接触 过 一 个 领导 力 培 训 项目 一 一 Bob Wiele 的 “领导 力 与 取得 成 功 的 四 个 维 
度 ”(http:/onesmartworld.com/) ， 其 中 介绍 了 一 系列 的 思维 策略 。 这 个 项 目 帮 助 我 明白 为 
什么 一 些 类 型 的 活动 会 让 我 觉得 很 享受 ， 而 另 一 些 却 让 我 感到 无 聊 。 它 还 教 给 我 很 多 ， 例 
如 怎样 组 织 会 议 ， 怎 样 与 别人 通过 交流 来 获得 工作 需要 的 资源 。 如 果 团 队 中 每 个 人 都 能 听 
懂 其 中 的 术语 ， 那 么 这 个 系统 将 最 有 成 效 ， 不 必 说 服 其 他 人 参与 ， 你 也 可 以 利用 这 个 系 
统 。 它 将 思维 拆 分 成 了 三 个 维度 : 创造 性 思维 、 理 解 性 思维 以 及 决策 性 思维 。 第 四 个 维度 
是 个 人 精神 ， 用 于 标示 一 个 人 可 能 的 参与 程度 。 我 认为 它 像 是 一 个 音量 旋钮 或 调节 器 ， 用 
来 控制 这 些 角色 扮演 游戏 中 的 成 员 。 
每 个 人 对 思维 策略 的 不 同 偏好 很 快 就 会 使 团队 出 现 分 歧 。 如 果 我 正在 进行 头脑 风暴 来 解决 
Git 中 的 合并 冲突 ， 而 你 告诉 我 本 不 该 使 用 变 基 (rebase), SRA ETSE. RE 
在 用 我 习惯 的 思维 方式 来 解决 问题 ， 而 你 用 你 惯用 的 思维 方式 打 断 了 这 场 对 话 。 广 意 ， 这 
些 偏 好 会 帮助 我 们 在 完成 以 下 事项 时 加 强 协 作 : 构建 新 功能 ， 组 织 更 高 效 的 代码 评审 ， 以 
及 打造 更 健康 快乐 的 团队 。 
在 借助 这 三 个 思维 维度 的 会 议 中 ， 我 们 最 容易 引入 配合 偏好 与 搁置 偏好 的 概念 。 确 保 会 议 
的 成 果 可 以 帮助 人 们 明白 在 会 议 中 采用 哪 种 思维 策略 好 ， 这 种 思维 可 以 接着 被 带 入 到 代码 
评审 中 ， 并 帮助 遇 到 Git 流程 问题 或 是 在 共同 开发 的 产品 上 遇 到 有 具体 实现 问题 的 同事 。 
让 我 们 更 具体 地 审视 一 下 上 面 提 到 的 几 种 思维 策略 。 
创造 性 思维 者 最 大 的 财富 是 能 够 找到 无 法 预见 的 问题 解决 方案 。 如 果 任 其 发 展 ， 那 么 创造 
性 思维 者 有 时 会 花费 太 多 时 间 思 考 不 同 的 解决 方案 ， 而 不 是 专注 于 一 个 想法 并 付 诸 实践 。 
创造 性 思维 者 具有 以 下 特征 。 
。 预见 未 来 

预见 另 一 种 未 来 (可 能 好 也 可 能 坏 )。 有 助 于 需要 长 期 战略 的 工作 。 
。 JR 

略微 偏离 现状 ， 或 换个 角度 审视 现状 。 
。 头脑 风暴 

有 助 于 突破 问题 。 头 脑 风暴 基本 等 同 于 天 马 行 空地 思考 问题 的 能 力 。 它 要 求 你 脱口 而 

出 ， 而 不 用 担心 说 错 。 
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。 灵光 一 闪 
头脑 风暴 需要 “费力 ”思考 ， 而 灵感 来 临时 你 并 没有 在 思考 这 个 问题 ， 或 许 你 正 出 门 散 
步 或 正在 洗澡 。 
。 勇于 质疑 
质疑 现状 。 叛 逆 者 、 童 话 《 皇 帝 的 新 装 》 里 指出 皇帝 光 着 身子 的 那个 小 孩 ， 都 是 勇于 质 
疑 的 例子 。 
。 保持 专注 
排除 和 干扰， 专注 于 某 项 任务 。 在 不 被 打 断 的 工作 流 中 ， 你 可 以 更 深入 地 思 翘 问题， 六 
全 面 地 理解 问题 。 
以 下 是 创造 性 思维 者 的 一 些 惯用 语 。 
。 “我 们 能 不 能 试 着 …… ” 
。 “我 知道 我 们 已 经 做 完了 ， 但 …… 怎么 办 ? ” 
。 “我 的 天 ! 我 突然 有 了 一 个 绝妙 的 想法 …… 
。 “你 有 没有 想 过 这 样 做 ? ” 
通过 培养 团队 的 创造 性 思维 ,你 会 拥有 掌握 问题 的 全 新 方法 ， 进 而 得 以 改善 工作 流 并 解决 
更 大 的 问题 。 
下 一 个 类 别 的 思维 是 理解 性 思维 。 它 可 以 分 为 两 类 : 理解 信息 (分 析 型 ) 和 理解 他 人 (El 
理 心 )。 分 析 型 思维 者 最 大 的 财富 是 能 够 发 现 规律 、 前 明 现 状 。 科 技 行业 倾 癌 于 吸引 有 具 
这 些 思维 策略 的 人 。 分 析 型 思维 者 具有 以 下 特征 。 
。 评估 现状 
调查 所 处 的 环境 ， 搜 集 尽 可 能 多 的 信息 。 
。 阐明 现状 
通过 搜集 信息 和 提出 问题 来 和 弄 清 当前 的 情形 。 
。 善于 组 织 
合理 、 系 统 地 组 织 数据 、 人 员 、 资 源 和 过 程 。 
。 敏锐 感知 
感知 和 理解 当前 情景 下 的 情绪 。 
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。 产生 共鸣 
包容 和 理解 他 人 的 想法 、 情 绪 和 处 境 。 
。 善于 表达 


选择 合适 的 情绪 和 言语 向 听众 传递 正确 的 信息 。 
以 下 是 分 析 型 思维 者 的 一 些 惯 用 语 。 


。 “你 的 意思 是 …… 吗 ?“ 





。“ 解 释 一 下 ……” 
“你 能 告诉 我 怎样 去 ……? ” 
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。“ 这 和 …… 有 关 吗 ?” 
“我 做 了 一 张 电子 表格 ……” 
。“ 那 一 定 很 可 怕 吧 ! ” 


最 后 介绍 “ 敢 作 敢当 ”的 思维 策略 : 决策 性 思维 。 有 些 人 不 喜欢 反复 其 酌 。 他 们 想 要 一 个 
迅速 的 决策 ， 然 后 进入 下 一 步行 动 ! 决策 技能 帮助 团队 找到 问题 的 根源 ， 然 后 决定 如 何 继 
续 。 决 策 性 思维 者 的 弱点 是 缺乏 耐心 。 他 们 通常 在 创造 性 思维 者 提出 可 能 的 最 佳 方案 或 者 











完成 绩 密 的 分 析 之 前 ， 就 跳 到 了 其 他 人 的 前 

















看 。 决 策 性 思维 者 有 时 会 被 误解 为 表现 消极 。 





这 是 一 种 误解 。 利 用 他 们 的 能 力 快速 找到 最 佳 方案 ， 这 是 弥 足 珍贵 的 。 决 策 性 思维 者 具有 


以 下 特征 。 
。 分 清 主 次 
看 透 本 质 ， 也 就 是 问题 中 最 重要 的 部 分 。 


. 善于 总 


Edi 





寻找 符合 逻辑 的 决策 或 方案 ， 以 最 好 的 方式 继续 前 行 。 


。 验证 结论 





提出 问题 ， 排 除 劣质 的 方案 和 无 用 的 信息 ， 审 愤 评 估 并 确保 决策 是 最 佳 的 。 


。 身体 力行 


依靠 亲身 体验 引导 决策 的 制定 和 问题 的 解决 。 


。 价值 驱动 


依靠 自己 的 核心 理念 分 辩 事 物 的 好 坏 与 对 错 。 


。 相信 直觉 


不 依靠 信息 ， 而 是 用 直觉 和 本 能 引导 决策 的 产生 。 


以 下 是 决策 性 思维 者 的 一 些 惯 用 语 。 


。“ 我 已 经 准备 好 进入 下 一 阶段 的 ……” 
。“ 不 行 。 我 们 已 经 决定 了 ……" 

，“ 我 不 知道 我 为 什么 会 想到 这 ， 但 是 ……” 
，“ 上 次 我 们 尝试 这 么 做 的 时 候 ……” 

。“ 我 认为 问题 的 本 质 是 ……” 

。“ 直 觉 告诉 我 .…… 


13 团队 会 议 























我 的 整个 职业 生涯 几乎 都 是 在 分 布 式 团队 中 度 过 的 ， 我 和 同事 不 在 同一 个 办 公 室 。 我 们 在 
同一 个 时 区 都 是 少 有 的 事 。 这 些 经 历 让 我 形成 了 不 少 良好 的 沟通 习惯 ， 我 常常 将 这 些 习 惯 
当 作 是 理所当然 的 。 如 果 你 在 工作 中 使 用 的 是 约定 好 的 方法 ， 那 么 你 的 团队 或 许 已 经 有 一 














套 推进 项 目的 会 议 模式 。 














你 的 项 目 以 及 其 中 的 每 个 子 模块 ， 都 应 该 有 开头 、 主 体 和 结尾 三 个 部 分 。Dave Gray, 
Sunni Brown 和 James Macanufo 合 著 的 Gamestorming  (http://shop.oreilly.com/product/97805 
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96804183.do) 一 书 详细 阐述 了 “开头 一 主体 一 结尾 ”这 一 流程 。 这 个 流程 还 被 教师 应 用 于 
课堂 教学 : 教师 首先 告诉 你 学 什么 ， 让 你 参与 学 习 ， 然 后 总 结 你 学 到 的 知识 。 

回 到 会 议 安 排 上 来 ， 你 应 该 在 脑 中 熟 记 这 个 规律 : 开场 、 参 与 、 总 结 。 这 个 规律 最 适用 于 
会 议 。 我 经 常 看 到 一 些 会 议 ， 准 备 了 讨论 话题 的 大 纲 ， 但 最 后 的 结果 却 差 强人 意 。 例 如 ， 
项 目 刚 开始 时 ， 团 队 正在 参与 构思 会 议 ， 创 造 性 思维 者 的 参与 最 为 积极 且 成 效 显 著 ， 如 下 
所 示 。 
时 间 表 : 构思 阶段 总 时 间 为 45 分 钟 

。 辨别 问题 本 质 (10 分 钟 ) 

。 头脑 风暴 ,寻找 解决 方案 (25 分 钟 ) 

。 整理 想法 (5 分 钟 ) 

。 挑选 至 多 三 个 想法 进行 验证 (5 分 钟 ) 

提前 制定 会 议 目标 非常 容易 ， 这 样 就 可 以 用 一 些 自 由 时 间 来 讨论 问题 。 


1.3.1 项 目 启动 

项 目 启动 会 是 一 个 混乱 的 时 期 ， 尤 其 当 你 召集 的 是 一 个 新 团队 ， 而 团队 的 成 员 在 工作 上 没 
有 交集 时 。 如 果 有 可 能 ， 请 召集 一 个 全 员 参 与 的 启动 会 议 。 对 分 布 式 团队 来 说 ， 时 间 和 人 金 
钱 的 代价 会 是 异常 昂贵 的 。 

面对面 的 会 议 更 佳 

理想 情况 下 ， 启 动 会 议 是 面对面 进行 的 。 如 果 难 以 实现 ， 试 着 将 人 们 聚集 到 
尽量 少 的 儿 个 地 点 ， 然 后 使 用 视频 电话 召开 会 议 。 













































































当 所 有 人 共处 一 地 时 ， 你 可 以 充分 利用 他 们 共度 的 时 光 。 你 可 以 借助 白板 、 活 页 挂图 和 便 
利 贴 ， 用 动作 来 表达 你 的 想法 。 看 到 大 家 共同 作出 的 决策 是 非常 令 人 高 兴 的 ， 它 有 助 于 激 
励 团 队 一 起 参与 到 项 目 中 来 。 


1.8.2 追踪 进展 


项 目 开 始 后 ， 你 会 希望 定期 与 团队 开 个 会 。 当 你 在 分 布 式 团队 中 工作 时 ， 逃 避 问 题 是 非常 
容易 的 事 。 跟 不 上 进度 是 一 件 很 令 人 难堪 的 事 ， 而 且 通 常 是 一 个 复杂 的 问题 。 保 持 沟 通 是 
一 个 处 理 此 类 问题 的 好 习惯 ， 但 这 并 不 意味 着 要 将 所 有 时 间 浪 费 在 开会 上 。 成 功 的 团队 总 
是 有 着 明确 的 目标 。 我 喜欢 一 周一 次 的 、 非 常 短小 的 冲刺 周期 。 在 这 么 短 的 时 间 内 很 难 隐 
藏 什么 问题 。 不 过 ， 它 和 微观 管理 没有 关系 。 它 的 目的 在 于 保证 项 目 持续 推进 。 以 下 每 个 
会 议 都 有 一 个 与 项 目 相关 的 具体 目标 。 
。 冲刺 计划 会 议 
作为 项 目 经 理 ， 我 发 现 有 两 种 类 型 的 员工 : 其 中 一 种 员工 随时 准备 接手 新 的 工作 并 对 做 
完 的 工作 负责 ， 而 另 一 种 员工 倾向 于 别人 为 他 们 安排 好 工作 。 那 些 希 望 别 人 为 他 们 安排 
工作 的 成 员 经 常 寻求 帮助 ， 来 弄 清 楚 他 们 能 胜任 哪些 任务 ， 以 及 从 项 目 整体 来 说 哪些 任 
务 有 最 高 的 商业 价值 。 冲 刺 计 划 会 议 可 以 赣 请 爹 员 参 与 ， 而 如 果 你 不 希望 在 冲刺 计划 会 
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议 上 耗费 过 多 时 间 ， 也 可 以 仅 让 跟 客户 打交道 的 成 员 和 高 级 开发 者 参与 。 

承诺 会 议 

这 类 会 议 应 该 挑选 每 周 儿 天 中 的 同一 时 间 召 开 。 会 议 的 成 果 是 团队 成 员 针 对 他 们 工作 中 
作出 的 “承诺 ”进行 汇报 。 他 们 不 应 该 只 汇报 “今天 在 做 什么 ”， 还 应 该 汇报 “下 次 开 
会 前 计划 完成 哪些 工作 "。 会 议 应 该 是 采用 “不 责备 ， 不 让 人 羞愧 ”的 轮流 发 言 方式 ， 
每 个 人 汇报 进展 的 时 间 不 应 该 超过 三 分 钟 。 更 大 的 具体 问题 可 以 留 到 后 续 的 会 议 中 去 讨 
W. Æ Scrum 的 用 语 中 ， 这 类 承诺 会 议 称 为 “站 立会 议 "， 参 会 者 一 般 站 着 参加 会 议 。 
我 发 现 “ 站 立 ” 对 于 那些 没有 接受 过 Scrum 训练 的 团队 来 说 并 不 准确 。 使 用 适合 你 的 
团队 的 术语 ， 但 要 确保 你 能 从 会 议 中 获得 有 价值 的 信息 。 

深入 研讨 会 议 

任何 承诺 会 议 之 后 还 需要 识 入 讨论 的 问题 都 应 该 安排 一 个 后 续 的 识 入 研讨 会 议 。 在 
理想 情况 下 ， 你 的 团队 将 使 用 一 个 日 程 系统 ， 比 如 “谷歌 日 历 ”(http://google.com/ 
calendar) ， 成 员 可 以 在 上 面 查 看 同事 的 日 程 ， 并 很 容易 找 出 一 段 空 闲 时 间 来 安排 后 续 的 
讨论 。 一 般 来 说 ， 我 每 周 会 保留 一 两 个 45 分 钟 的 时 间 段 用 于 深入 研讨 会 议 ， 紧 接 在 两 
个 15 分 钟 的 承诺 会 议 后 。 只 有 相关 的 人 员 需 要 参加 深 入 研讨 会 议 ， 虽然 我 们 欢迎 任何 
人 加 入 。 

冲刺 演示 会 议 

团队 应 该 每 周 找 一 个 时 间 一 起 展示 工作 。 在 演示 会 议 中 ， 每 个 取得 成 果 的 成 员 应 该 列 出 
完成 的 工 单 号 ， 并 展示 工作 成 果 。 每 周 安排 一 次 演示 会 议 形 成 工作 “永远 即将 完成 ”的 
文化 ， 在 这 种 文化 中 ， 工 作 被 分 成 易于 执行 的 小 块 。 这 类 会 议 提供 了 一 个 绝 佳 的 机 会 ， 
让 你 发 现 新 想法 ， 分辨 可 能 需要 文档 记录 或 后 续 修复 的 bug， 或 者 是 讨论 下 一 个 冲刺 中 
必要 的 流程 改进 。 由 于 团队 的 凝聚 力 及 沟通 水 平 不 同 ， 你 或 许 会 觉得 这 些 会 议 是 不 必 
要 的 。 但 如 果 你 发 现 越 来 越 多 未 完成 的 功能 通过 了 代码 审查 ， 或 是 优秀 的 工作 没有 得 
到 重视 ， 或 是 发 现 你 的 团队 没有 经 常 相互 求助 ， 那 么 ， 是 时 候 引 进 每 周 的 演示 会 议 了 。 
Google Hangouts (http://www.google.com/-/learnmore/hangouts) 和 GoToMeeting (http:/ 
gotomeeting.com/) 非常 适合 这 种 会 议 。 

冲刺 回顾 会 议 

在 每 个 冲刺 结束 的 时 候 ， 你 应 该 召集 团队 一 起 讨论 工作 流程 。 找 出 运转 良好 的 部 分 以 及 
需要 改进 的 部 分 。 我 有 一 个 行 之 有 效 的 方法 ， 即 让 每 个 成 员 用 下 面 这 些 提示 语 作答 : 我 
希望 ;我 想 要 ， 我 担心 。 这 个 会 议 应 该 只 邀请 核心 成 员 参 加 。 会 议 时 间 可 长 可 短 ， 但 对 
小 团队 而 言 大 致 需要 一 个 小 时 。 

















































































































在 一 个 分 布 式 团队 中 ， 你 可 能 还 需要 安排 一 些 定期 的 社交 电话 会 议 。Lullabot (http:/ 
lullabot.com/) 是 一 个 完全 分 布 式 的 公司 ， 拥 有 大 约 50 名 员工 。 它 将 下 面 儿 个 与 项 目 无 关 
的 电话 会 议 加 到 了 日 程 中 。 以 下 会 议 的 目的 是 培养 成 员 之 间 的 同 理 心 。 




















全 公司 的 站 立会 议 
每 周 举行 一 次 电话 会 议 ， 通 过 抽签 选 出 发 言 者 ， 每 人 用 不 超过 两 分 钟 的 时 间 聊 一 聊 他 们 
的 工作 和 业余 生活 。 当 公司 的 规模 还 小 时 ， 每 个 人 都 要 在 这 个 会 议 上 发 言 。 随 着 公司 规 
模 增长 ， 这 个 抽签 的 系统 便 应 运 而 生 ， 一 对 一 的 电话 会 议 也 加 进 了 日 程 。 
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。 一 对 一 会 议 

通过 抽签 选 出 两 三 名 员工 ， 找 个 方便 的 地 方 交流 各 自 的 生活 、 兴 趣 等 任何 二 
最 重要 的 是 ， 这 些 电话 会 议 只 有 语音 ， 成 员 可 以 在 打 电 话 的 时 候 做 别 的 事情 ( 往 洗 碗 机 上 
装 盘子 ， 如 果 手 机 信号 够 好 ， 甚 至 可 以 在 室外 活动 )。 


1.3.3 ”培养 同 理 心 


当 你 在 分 布 式 团队 中 工作 时 ， 将 代码 团队 中 的 成 员 视 为 “资源 ”而 不 是 个 体会 容易 得 多 。 
培养 团队 间 的 信任 关系 需要 有 意识 的 努力 。 彼 此 信任 而 不 是 县 惧 的 团队 将 会 诞生 更 多 灵 
感 ， 也 将 更 愿意 在 困境 中 寻找 合适 、 创 新 的 解决 方案 。 


提升 团队 的 同 理 心 的 第 一 步 是 恰如其分 地 关心 你 的 同事 。 你 不 需要 成 为 每 个 人 的 心理 治疗 
师 ， 但 花 点 时 间 和 他 们 聊 聊 私下 的 生活 会 是 非常 值得 的 。 如 果 你 被 认为 很 有 爱心 ， 大 家 会 
更 加 喜欢 你 ， 从 而 增进 你 们 之 间 的 信任 。 作 为 技术 型 的 项 目 经 理 ， 经 常 有 人 邀请 我 倾听 他 
门 讨论 问题 。 在 他 们 为 我 介绍 问题 背景 之 后 ， 我 对 问题 粗浅 的 理解 可 以 迫使 关注 点 回 到 问 
题 的 本 质 ， 也 就 是 解决 方案 的 来 源 。 但 这 种 对 话 在 新 团队 中 鲜 有 发 生 ， 因 为 我 必须 先 取得 
团队 中 每 个 人 的 信任 〈 在 他 们 不 知道 正确 答案 时 ， 我 不 会 妄 加 评判 ， 我 会 帮助 他 们 专注 于 
解决 问题 ， 而 不 是 在 他 们 讨论 时 只 顾 自己 打字 )。 


以 下 是 一 些 帮 助 你 表现 出 “恰如其分 ”的 关心 的 方法 。 


。 搜集 故事 
询问 人 们 的 日 常生 活 ， 关 于 他 们 正在 解决 的 有 意思 的 挑战 ， 关 于 你 们 共事 的 项 目 中 他 们 
喜欢 (或 不 喜欢 ) 的 地 方 。 这 不 是 一 个 用 聊 的 机 会 ! 这 是 一 个 将 谈话 对 象 和 他 们 的 生活 
联系 起 来 的 好 机 会 。 

。 带 有 目的 地 倾听 
当 你 和 人 们 交谈 时 ， 专 广 地 倾听 。 不 要 同时 做 几 件 事 情 。 完 整地 倾听 他 们 所 说 的 内 容 。 
不 要 打 断 他 们 ， 除 非 你 感到 困惑 ， 希 望 得 到 解释 。 一 些 人 是 天 生 的 演讲 家 ， 总 是 能 滔滔 
不 绝地 讲 下 去 。 对 于 这 些 人 ， 你 或 许 希望 预先 计划 一 个 结束 的 时 间 点 。 


。 旧事 重 提 
如 果 有 人 和 你 谈 起 过 他 们 的 生活 ， 时 不 时 间 问 他 们 之 前 的 故事 有 什么 变化 。 他 们 的 女儿 
还 在 长 牙 吗 ? 感冒 怎么 样 了 ? 今天 好 一 些 了 吗 ? 


我 郑 虑 将 这 个 清单 视 为 “ 同 理 心 的 培养 ”(http:Wgitforteams.com/resources/cultivating- 
empathy.html) 。 每 个 人 能 够 做 到 并 且 也 应 该 和 同事 保持 一 定 的 联系 。 


1.3.4 回顾 


上 述 会 议 是 总 结 经 验 、 取 长 补 短 的 最 佳 时 机 。 这 些 会 议 还 应 该 整理 未 来 可 以 重用 的 模板 。 
一 段 工作 的 结束 会 议 应 该 是 不 责备 、 不 让 人 羞愧 的 ， 人 们 可 以 畅谈 做 得 不 好 的 地 方 。 作 为 
项 目 经 理 ， 我 很 少 为 我 的 决定 感到 后 悔 。 我 依靠 团队 提供 的 信息 来 帮助 我 作出 最 好 的 决 
策 。 所 以 在 回顾 中 ， 我 总 是 很 容易 避免 一 些 “ 本 来 应 该 、 可 以 这 么 做 ”的 诱惑 。 不 过 ,我 
确实 在 留意 一 些 面 向 未 来 的 模式 。 换 言 之 ， 明 确 我 们 在 会 议 中 提出 的 哪些 问题 本 可 以 得 到 
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解决 ， 以 获得 另 一 些 有 用 的 信息 (这 些 信息 或 许 会 让 我 们 在 未 来 遇 到 同类 项 目 时 能 够 作出 
更 好 的 决策 )。 

从 版 本 控制 的 角度 来 说 ， 项 目的 终点 也 是 一 个 巨大 的 机 遇 ， 你 可 以 挑 出 你 最 喜欢 的 工 单 ， 
记录 它们 与 众 不 同 的 原因 。 或 许 它 提出 了 一 种 组 织 信息 的 新 方式 ， 而 你 想 要 重用 这 一 点 。 
看 一 看 Git 仓库 ， 寻 找 一 些 特 别 好 的 提交 信息 ， 供 以 后 的 项 目 参考 。 


1.4 Git 中 的 团队 协作 


如 果 你 尚未 接触 过 分 布 式 版 本 控制 ,会 看 到 一 些 术 语 人 贯穿 了 本 书 剩 下 的 部 分 。 这 些 术语 在 
简单 的 开发 者 工作 流 中 最 容易 理解 。 

每 个 开发 者 都 有 一 个 本 地 的 仓库 副本 ， 即 项 目 中 的 更 改 历史 的 独立 副本 。 为 了 共享 更 改 ， 
开发 者 一 般 会 将 一 份 仓库 的 副本 发 布 到 一 个 集中 式 的 代码 托管 系统 ， 如 GitHub。 尽 管 如 
此 ， 正 如 你 将 在 本 章 剩 下 的 部 分 中 了 解 到 的 那样 ， 会 有 很 多 种 分 享 代码 的 方法 。 

在 仓库 的 中 央 副 本 中 ， 开 发 者 将 会 创建 一 个 他 们 可 以 更 改 的 仓库 副本 。 在 Git 的 用 语 中 ， 
这 个 过 程 称 为 克隆 副本 ， 尽 管 这 个 过 程 也 可 以 称 为 派生 (forking). 


在 克隆 仓库 时 ， 软 件 开发 者 可 以 选择 将 他 们 的 项 目 副本 设置 为 私有 的 或 公开 的 。 一 个 私有 
仓库 默认 不 希望 别人 直接 查看 这 个 副本 ， 而 只 通过 查看 主 项 目 来 获得 被 官方 接受 的 更 改 。 
另 一 方面 ， 任 何人 都 可 以 直接 向 开发 者 的 仓库 的 公开 副本 提交 贡献 。 对 于 软件 开发 来 说 ， 
这 是 一 个 更 加 开放 的 策略 ， 但 可 能 会 让 人 对 哪个 副本 才 是 项 目的 起 点 感到 困惑 。 

只 有 通过 项 目 治理 才能 决定 哪 一 个 仓库 是 最 重要 的 版 本 。 这 是 因为 每 个 仓库 都 可 以 接受 更 
改 ， 并 与 外 界 共享 更 改 。 项 目 之 间 的 关系 不 是 一 成 不 变 的 。 你 可 以 在 不 同 的 仓库 副本 间 建 
立 关系 网 络 ， 或 者 建立 一 个 线性 的 关系 链 。 但 一 般 来 说 ， 软 件 产品 的 官方 版 本 称 为 当前 仓 
库 的 上 游 。 例 如 ， 我 的 博客 是 通过 Sculpin (https://getsculpin.com/) 创建 的 。 我 将 这 个 软 
件 的 官方 发 布 版 本 克隆 下 来 ， 并 直接 修改 这 个 仓库 来 编写 博文 。 如 果 我 希望 获得 软件 最 新 
的 更 改 ， 将 会 并 入 上 游 的 更 改 。 

派生 一 份 新 的 奶油 塔 食谱 

对 长 期 开源 软件 开发 者 来 说 ,派生 (fork) 这 个 术语 出 现时 ， 往 往 是 一 个 分 
裂 的 社区 充满 了 对 项 目的 失望 ， 一 群 开 发 者 决定 “派生 一 份 新 的 项 目 "， 然 
后 朝 着 不 同 的 方向 发 展 。 派 生 简单 来 说 就 是 偏离 主 路 ， 就 像 一 条 林 戎 小 路 ， 
或 是 我 的 曾祖 母 Austin 的 奶油 塔 食谱 。 每 个 派生 的 分 支 指向 了 不 同方 向 。 在 
这 个 奶油 塔 的 例子 中 ， 就 是 加 或 不 加 小 葡萄 和 干 。 你 可 以 在 附录 A 中 读 到 我 家 
的 派生 食谱 。 

























































































在 一 个 单独 的 仓库 中 ， 我 可 以 存放 项 目的 不 同 版 本 。 这 些 仓库 内 的 更 改 可 以 通过 分 支 进 
行 追 踪 。 为 了 从 我 当前 的 分 支 切换 到 另 一 个 ， 我 将 会 签 出 (check out). 我 想 要 切换 过 去 的 
分 支 。( 我 心中 默念 “这 个 太 酷 了 ， 快 签 出 看 看 "。) 在 切换 前 ，Git 将 会 强制 要 求 我 处 理 
未 提交 的 更 改 ， 要 么 提交 ， 要 么 舍弃 。 提 交 过 程 会 将 我 的 更 改 持久 存储 到 仓库 ， 而 储 茂 
(stash) 将 会 暂 存 更 改 ， 允 许 你 随后 拉 取 你 刚刚 储藏 的 工作 并 重新 应 用 。 
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手工 艺人 的 储藏 物 

编织 者 、 裁 颖 和 其 他 纤维 艺术 家 通常 会 储藏 一 些 纱 线 和 织物 。 当 一 个 新 的 项 
目 开 始 时 ， 我 们 可 能 去 “储藏 室 购物 ”而 不 是 去 商店 。 那 些 储藏 量 巨大 的 人 
也 许 会 谈 到 “达到 了 SABLE 的 状态 ” (储藏 的 纱 线 一 辈子 都 用 不 完 )。 我 认 
为 这 个 类 比 对 Git 的 储藏 物 来 说 也 适用 ， 和 手工 艺 一 样 ， 我 推荐 定期 清理 储 
藏 物 以 防虫 性。 如 果 你 是 一 位 编织 者 ， 你 会 喜欢 上 Git for Knitters (https:// 
github.com/gitforknitters/gitforknitters ) 。 






































并 入 和 发 布 更 改 的 过 程 使 用 了 下 面 这 些 命令 。 我 从 远 端 仓库 抓 取 (pul) 更 改 ， 然 后 自 
动 并 入 我 的 仓库 。 这 个 过 程 拉 取 (fetch) 新 的 更 改 并 将 它们 合并 (merge) 进入 本 地 分 支 
(branch) 的 跟踪 (tracked) 副本 。 不 管 什么 时 候 ， 我 在 我 的 仓库 的 本 地 分 支 上 工作 。 如 果 
想 与 其 他 开发 者 共享 更 改 ， 我 会 将 我 的 工作 提交 至 仓库 ， 然 后 将 我 的 分 支 推 送 (push) 到 
远 端 仓库 。 


1.5 ”二 \ 结 


我 最 喜欢 做 的 一 件 事 是 与 一 个 面临 危机 的 团队 一 起 工作 ， 帮 助 他 们 找到 一 个 有 趣 且 充满 创 
造 性 的 全 新 工作 方式 。 这 个 过 程 并 不 总 是 一 帆 风 顺 的 ， 因 为 面临 危机 的 团队 或 多 或 少 都 存 
在 一 些 不 信任 。 在 这 个 过 程 中 有 时 会 有 泪水 ， 但 如 果 团 队 齐 心 协力 ， 最 后 的 回报 是 巨大 的 。 


。 一 个 彼此 信任 、 具 有 同 理 心 的 团队 更 可 能 帮助 同事 学 习 工 作 需 要 的 具体 Git 命令 。 

。 不 同 的 思维 策略 偏好 会 使 你 的 团队 偏离 方向 。 确 保 在 正确 的 时 间 使 用 正确 的 策略 来 减少 
团队 间 的 摩 探 ， 同 时 让 工作 进展 更 加 迅速 ， 带 来 更 多 乐趣 。 

。 通过 保持 工作 的 透明 ， 并 在 关键 时 刻 引 入 利益 干系 人 ， 你 可 以 缩短 代码 的 测试 时 间 并 减 
少 发 现 的 bug 数量 ， 从 而 获得 更 快 的 部 署 。 


在 下 一 章 中 ， 你 将 会 开始 学 习 项 目 仓库 的 治理 。 
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第 2 章 


命令 与 控制 





从 定义 上 看 ， 分 布 式 版 本 控制 系统 避免 了 集中 式 系统 的 权限 控制 方式 。Git 没有 提供 内 置 
的 规则 来 帮助 你 控制 代码 的 访问 权限 ， 它 只 是 一 个 内 容 跟踪 工具 。 如 果 你 已 经 习惯 了 版 本 
控制 系统 同时 扮演 守门 人 和 访问 控制 管家 的 角色 ， 那 么 着 实 会 感受 到 明显 的 不 同 。 没 有 集 
中 式 权限 控制 并 不 意味 着 你 的 项 目 将 立即 陷入 混乱 的 状态 。 

在 2.1 广 中， 你 将 学 到 以 下 内 容 。 

。 原作 者 、 版 权 及 分 发 许可 。 

。 领导 力 模型 ， 为 项 目的 贡献 规范 定 下 基调 。 

。 行为 守则 ， 制 定 一 份 指南 ， 明 确 贡献 考 的 预期 行为 和 可 接受 的 行为 。 

接 下 来 ， 在 2.2 市 中 ， 你 会 学 到 如 何 设 置 项 目的 访问 权限 。2.2 市 介绍 了 下 面 三 个 模型 。 

。 分 散 贡 献 者 

。 并 列 贡献 者 仓库 

。 共享 维护 

学 完 本 章 ， 你 将 能 够 自信 地 为 你 的 团队 建立 一 个 访问 模型 ， 既 让 贡献 者 满意 ， 也 确保 你 能 
够 遵从 监管 机 构 的 任何 管理 要 求 。 


2.1 项 目 治理 


如 果 要 我 打赌 ， 我 会 赌 你 拿 起 这 本 书 的 目的 是 为 了 学 习 Git。 本 市 介绍 的 是 法 律 条 文 。 如 
果 你 素来 没有 耐心 ， 那 么 也 许 会 想 知 道 为 什么 我 要 在 这 个 星 淮 的 主题 上 浪费 宝贵 的 时 间 。 
把 这 些 资料 当 作 一 本 入 门 读 物 ， 了 解 自 己 的 作者 权利 以 及 项 目 管理 的 责任 。 越 来 越 多 的 政 
府 和 大 型 企业 开始 使 用 公开 发 布 的 代码 ， 并 选择 开源 自己 的 代码 。( 如 今 连 微软 都 有 了 不 
少 开源 库 ! 微软 加 油 ! ) 
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开发 开源 软件 

在 本 章 中 ， 我 会 讲 到 项 目 运营 的 要 点 。 如 果 软 件 开 发 者 和 管理 者 正在 考 
虑 开源 他 们 的 项 目 ， 他 们 应 该 读 一 读 Karl Fogel 的 Producing Open Source 
Software (http://producingoss.com/)。 这 本 免费 图 书 涉及 了 开源 项 目 运 营 的 方 
方面 面 ， 既 包括 宣传 、 增 长 ， 也 涵盖 法 律 事 务 和 政治 结构 。 





























在 本 节 中 ， 你 将 会 了 解 到 一 段 代 码 的 归属 。 然 后 ， 当 你 用 Git 工作 时 ,会 看 到 Git 允许 你 
追踪 仓库 中 每 一 份 代码 的 作者 。 不 仅 如 此 ， 你 甚至 可 以 为 添加 到 仓库 的 每 一 份 代码 加 上 
签名 。 


2.1.1 版 权 和 贡献 者 协议 


版 权 是 在 使 用 和 分 发 作品 时 排他 且 可 转让 的 法 律 权利 。 世 界 各 地 的 版 权 法 律 的 细节 不 尽 相 
同 ， 但 一 般 来 说 作者 有 权 复 制 和 分 发 自己 的 作品 。 在 开源 软件 中 ， 版 权 所 有 者 同意 将 他 
们 的 作品 授权 给 更 多 人 。 流 行 的 自由 开源 软件 (Free Libre Open Source Software, FLOSS) 
的 分 发 许可 将 在 下 一 节 中 介绍 。 


如 果 作 者 是 有 偿 完 成 工作 中 的 产品 ， 作 品 的 版 权 通常 会 归属 于 付款 人 或 赞助 人 。 在 美 
国 ， 这 称 为 许 用 作品 (work for hire)， 儿 乎 总 是 针对 雇主 一 雇员 关系 ， 且 一 般 针对 合约 
雇员 。 如 果 你 不 确定 你 是 否 拥有 作品 的 版 权 ， 请 检查 一 下 你 的 协议 。 如 果 没 有 这 样 的 条 
款 ， 可 以 去 当地 的 司法 机 构 查询 是 否 已 有 先例 。 在 美国 ， 根 据 最 高 法 院 给 出 的 定义 (http:// 
copyright.gov/circs/circ09.pdf) ， 合 约 雇员 和 自由 工作 者 的 作品 不 受 该 限制 ， 不 属于 雇用 作 
品 。 不 过 ， 这 项 条 款 非 常 模糊 。 在 理想 情况 下 ， 最 好 完善 你 的 合同 ， 明 确 规 定 作品 的 版 权 
归属 。 


版 权 只 保护 作品 的 具体 实现 。 你 不 能 为 一 个 想法 声明 版 权 。 你 也 许 听 说 过 北向 工程 
(reverse engineering) ， 这 是 一 种 规避 某 个 作者 对 作品 的 正当 权益 的 做 法 。 世 界 上 某 些 地 方 
的 司法 机 构 还 有 一 项 竞 业 限 制 (restraint of trade) 条 款 。 这 项 条 款 禁止 雇员 (或 合约 雇员 ) 
在 一 段 时 间 内 参与 别处 的 类 似 工 作 。 这 项 条 款 有 效 避 免 了 雇员 在 接受 新 的 工作 后 侵权 或 仿 
照 为 前 雇主 开发 的 作品 。 法 庭 必 须 认 可 这 是 一 个 “合理 ”的 约束 ， 限 制 雇员 从 事 某 个 特定 
行业 或 某 些 具体 工作 内 容 ， 而 不 能 被 扩大 地 解释 为 禁止 雇员 从 事 任 何 工 作 。 


在 一 些 法 律 中 ， 专 利 确实 涉及 了 发 明 背 后 的 想法 。 软 件 专利 尤其 受到 争议 ， 因 为 人 们 察觉 
到 它们 在 许多 情况 下 扼杀 了 创新 。 专 利 向 来 不 是 自动 授权 的 ， 而 是 必须 在 特定 地 区 提交 
请 的 。 


如 有 果 你 代表 雇主 参与 一 个 开源 项 目 ， 版 权 的 分 配 或 许 会 更 复杂 一 些 。 如 采 项 目的 政策 规定 
只 接受 个 人 的 贡献 ， 而 你 的 雇用 者 保留 了 你 的 作品 的 全 部 版 权 ， 这 会 变 得 尤为 复杂 ， 你 的 
公司 可 能 规定 了 你 可 以 在 业余 时 间 做 什么 工作 。( 我 知道 的 一 些 开源 项 目 和 公司 确实 有 这 
样 的 限制 。) 我 不 是 律师 ， 因 此 无 法 给 你 法 律 意见 。 你 能 做 的 只 有 事前 寻求 权限 或 事后 达 
成 共识 。 但 是 ,我 可 以 向 你 强调 版 权 的 重要 性 ， 并 鼓励 你 从 长 远 利益 孝 虑 最 合适 的 做 法 。 
如 果 你 的 贡献 因为 某 些 原因 不 得 不 从 一 个 开源 项 目 中 被 移 除 ， 对 你 来 说 就 有 点 可 惜 了 。 虽 
然 彻底 地 坦诚 存在 风险 ， 但 我 认为 最 终 这 会 是 值得 的 。 
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为 了 保障 自己 未 来 的 权利 ， 一 些 公司 在 公共 项 目 中 放置 了 贡献 者 协议 。Canonical (http:/ 


www.ubuntu.com/legal/contributors), Chef (https://docs.chef.io/community, contributions. 





html), Puppet (https://cla.puppetlabs.com/), Google (https://cla.developers.google.com/ 
about/google-individual) 和 .NET (https://cla.dotnetfoundation.org/) 都 有 自己 的 贡献 者 许可 
协议 。 协 议 因 公司 而 异 ， 但 它们 的 主旨 相同 :“ 如 果 你 选择 提交 一 个 贡献 ， 你 同意 将 你 的 
版 权 转让 给 这 个 项 目 .” 正 如 文字 作品 的 创作 共用 (Creative Commons) 协议 一 样 ， 同 样 有 
一 个 贡献 协议 的 Harmony Agreement 模板 (http:Wharmonyagreements.org/) 。 贡 献 者 协议 存 
在 的 最 根本 原因 是 它 允 许 项 目 无 需 个 人 贡献 者 的 明确 同意 就 可 更 改 项 目的 分 发 许可 。 在 开 
源 软件 中 ， 这 些 贡献 者 协议 经 常 被 认为 与 开源 精神 背道而驰 。 但 另 一 方面 ， 如 果 公 司 不 拥 
有 软件 的 版 权 ， 未 来 若 要 做 出 与 法 律 相关 的 决策 将 会 是 非常 困难 的 。 


2.1.2 分 发 许可 

一 旦 你 决定 如 何 处 置 你 项 目的 版 权 ， 接 下 来 要 做 的 便 是 创建 一 个 分 发 许可 。 它 将 曾 述 你 希 
望 别 人 如 何 使 用 或 不 能 如 何 使 用 你 的 项 目 。 

GitHub 将 它 推荐 的 一 些 流行 开源 许可 (http://choosealicense.com/) 编 成 了 一 本 出 色 的 入 门 
手册 。 这 份 手册 包括 了 以 下 的 许可 证 。 


e MIT 许可 证 (http://opensource.org/licenses/MIT) 允许 人 们 在 注 明 原作 者 的 前 提 下 自由 
使 用 代码 ， 并 且 你 不 需要 为 衍生 的 软件 负责 。jQuery 和 Rails 均 使 用 MIT 许可 证 。 

e Apache 许可 证 (http://www.apache.org/licenses/LICENSE-2.0.html) 类 似 于 MIT 许可 证 ， 
但 明确 将 原作 者 的 专利 授权 给 用 户 ， 并 要 求 用 户 提供 变更 说 明 ， 描 述 你 的 作品 在 之 前 的 
版 本 上 做 了 哪些 修改 。Apache、Subversion 和 NuGet 均 使 用 Apache 许可 证 。 

e GNU General Public License (GPL) 分 为 V2 (http://www.gnu.org/licenses/gpl-2.0.txt) 和 
V3 (http//www.gnu.org/licenses/gpl-3.0.txt) 两 个 版 本 。 它 是 一 个 共享 友好 的 版 权 协 议 ， 
要 求 作 品 或 衍生 品 的 分 发 者 将 源码 以 相同 协议 共享 。V3 版 本 与 V2 类 似 ， 但 进一步 限 
制 将 作品 用 于 禁止 软件 自 改 的 硬件 。Linux、Git 和 Word Press 均 使 用 这 种 许可 证 。 

。 如 果 你 的 作品 形式 不 是 代码 ， 创 作 共 用 许可 证 (http://creativecommons.org/) 可 能 
更 适合 你 的 作品 。 这 个 协议 允许 你 选择 重新 分 发 时 是 否 能 够 修改 以 及 能 否 用 于 商业 
目的 。 

你 也 完全 可 以 选择 不 使 用 分 发 许可 。 但 是 ， 这 意味 着 你 在 告诉 别人 : 你 不 介意 别人 未 经 明 

确 授权 就 使 用 你 的 作品 。 


什么 时 候 不 要 使 用 分 发 许可 

在 大 多 数 情 况 下 ， 在 公共 项 目 中 使 用 分 发 许可 都 是 一 个 好 的 做 法 。 也 就 是 
说 ， 有 时 我 不 会 为 一 些 公共 项 目 添加 分 发 许可 。 如 果 我 觉得 我 的 作品 会 被 收 
录 到 传统 出 版 商 的 完整 的 书 中 ， 我 一 般 会 选择 这 么 做 。 一 些 出 版 商 要 求 你 将 
版 权重 新 转让 给 他 们 ， 并 代表 你 保护 作品 。(O’Reilly 将 所 有 版 权 归 于 原作 
者 。) 如 果 我 的 作品 接受 了 被 一 个 开源 许可 保护 的 贡献 ， 这 可 能 会 影响 我 以 























































































































如 果 你 遇 到 了 一 个 没有 明确 提供 许可 的 公共 项 目 ， 并 且 希 望 使 用 它们 的 作品 ， 那 么 请 先 联 
系 项 目的 管理 者 ， 让 他 们 为 自己 的 作品 添加 一 个 分 发 许可 。 


2. 





13 ”领导 力 模型 


开源 软件 使 人 们 能 够 一 起 构建 更 强大 、 更 安全 、 功 能 更 丰富 、 可 维护 性 更 强 的 系统 ， 而 维 
护 软件 的 重任 由 大 家 一 同 分 担 。 如 果 你 的 项 目 只 有 一 位 成 员 ， 建 立 治理 文档 或 许 还 没 必 


要 








， 但 如 果 你 预计 会 有 其 他 贡献 者 加 入 ， 你 应 该 考虑 你 希望 项 目 如 何 运 转 。 


我 参与 过 的 治理 模型 包括 以 下 这 些 。 





仁 问 的 独裁 者 (BDFL) 

在 这 个 模型 中 ， 代 码 库 中 任何 地 方 的 任何 决定 都 由 项 目 领导 者 说 了 算 。BDFL 类 型 的 领 
导 者 或 许 不 会 活跃 于 每 次 代码 评审 中 ， 但 最 终 保留 了 驳回 或 撤销 某 个 决定 的 权力 。 整 个 
社区 任 由 他 宰割 。 听 起 来 很 可 怕 ， 不 是 么 ? 好 吧 ， 如 果 这 位 独裁 者 不 仁 蔚 ， 那 么 确实 如 
此 。 这 个 模型 已 经 成 功 应 用 于 Ubuntu 等 项 目 (https://en.wikipedia.org/wiki/Benevolent_ 
dictator for life), 


共识 驱动 、 主 管 批准 

Drupal 社区 使 用 的 共识 模型 鼓励 社区 在 自己 熟悉 的 领域 中 寻找 合适 的 解决 方案 。 当 社 
区 对 解决 方案 感到 满意 时 ， 他 们 将 这 个 issue 标记 为 RTBC [Reviewed and Tested by the 
Community， 通 过 社区 审核 与 测试 ， 与 Ready to be Committed (即将 提交 ) 的 英文 缩 
写 相 同 ]。Drupal 有 独立 的 工作 组 负责 内 容 、 版 权 和 安全 问题 (https:/www.drupal.org/ 
governance) 。 

技术 评审 委员 会 或 项 目 管理 委员 会 

Backdrop 是 由 Drupal 派生 出 去 的 一 个 项 目 ， 它 在 初期 就 采用 了 明确 的 治理 模型 
(https://backdropcems.org/leadership) ， 该 模型 是 基于 一 个 Apache 项 目的 项 目 管理 委员 会 
(PMC) 模型 (http://www.apache.org/foundation/governance/pmcs.html)。 



































如 果 你 在 设置 项 目的 治理 方案 时 需要 更 多 的 指导 ， 我 推荐 Lisa Welchman 编写 的 资料 ， 

















包括 她 的 一 本 名 为 Managing Chaos 的 图 书 (http://rosenfeldmedia.com/books/managing- 
chaos/) 。 
2.1.4 ”行为 守则 


如 果 一 些 成 员 对 他 人 不 够 友好 ， 有 时 一 些 社区 不 得 不 拒绝 他 们 的 代码 。 如 果 不 这 么 做 ， 那 
么 那些 社区 就 会 因为 其 中 不 其 友好、 难以 忍受 的 行为 而 臭名 昭著 。 你 或 许 会 想起 你 乐于 参 
与 的 一 些 社区 ， 并 且 和 希望 将 这 种 氛围 带 到 自己 的 项 目 中 。 


社 























区 文化 是 持续 强化 的 行为 守则 。 尽 管 你 或 许 会 希望 每 个 人 对 彼此 都 很 友好 ， 但 总 有 一 天 








你 还 是 会 希望 有 一 本 可 以 参考 的 条 例 手 册 。 一 份 社区 行为 守则 使 你 能 够 明确 规定 项 目的 参 





与 者 应 该 遵守 哪些 规定 。 一 些 行为 守则 已 经 久 经 社区 考验 ， 你 或 许 会 希望 借鉴 其 中 一 份 开 
































始 起 草 你 的 行为 守则 。 
据 我 所 知 ，Flickr 是 第 一 个 使 用 行为 守则 的 社区 ， 它 还 特地 确保 成 员 知道 社区 已 经 有 了 规 
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范 。 我 相信 自从 我 第 一 次 阅读 这 份 文 档 之 后 ， 它 已 经 修改 了 不 少 内 容 ， 你 可 以 在 Flickr 社 
区 规范 (https://www.flickr.com/help/guidelines) 中 读 到 最 新 的 版 本 。 

Drupal 社区 行为 守则 (https://www.drupal.org/dcoc) 是 我 最 熟悉 的 一 份 社区 行为 守则 。 它 
衍生 自 Ubuntu 社区 行为 守则 (https://launchpad.net/codeofconduct/1.0.1) 的 一 份 早期 版 本 
[现在 已 有 了 更 新 的 版 本 (http://www.ubuntu.com/about/about-ubuntu/conduct)] ， 并 且 启 发 
了 Humanitarian ID 社区 行为 守则 (http://humanitarian.id/code-of-conduct/)， 这 是 一 个 联合 
国人 道 主 义 事 务 协调 厅 项 目的 社区 行为 守则 。 

你 可 以 将 你 的 行为 守则 (Code of Conduct, CoC) 文档 放 在 项 目 网 站 上 。 如 果 你 的 项 目 没 
有 一 个 专门 的 网 站 ， 你 可 以 将 你 的 行为 守则 放 到 GitHub 上 的 一 个 Wiki 页 面 上 。 在 项 目 首 
页 上 方 的 选项 卡 中 可 以 找到 Wiki 页 面 的 链接 。 


2.2 访问 模型 


如 果 你 使 用 版 本 控制 系统 已 经 很 长 时 间 了 ， 那 么 或 许 会 想起 CVS、Subversion 等 使 用 中 央 
仓库 的 版 本 控制 系统 。 图 2-1 展示 了 在 Subversion 的 集中 式 系统 中 更 改 是 如 何 发 生 和 流动 
的 。 在 这 个 系统 中 ， 当 你 每 次 想 要 保存 一 份 仓 库 中 的 工作 快照 时 ， 你 和 所 有 人 的 快照 其 实 
都 存放 到 了 同一 个 地 方 。 当 你 想 要 共享 工作 ， 或 提交 代码 审查 时 ， 如 果 有 人 刚刚 在 同一 分 
支 更 新 他 们 的 工作 ， 你 可 能 就 无 法 完成 操作 。 












































上 传 工作 下 载 工作 


提交 签 出 














2-1; Subversion 中 的 文件 操作 


在 另 一 方面 ，Git 是 一 个 分 布 式 的 版 本 控制 系统 。 也 就 是 说 ， 与 强制 将 更 改 记 录 在 中 央 仓 
库 的 集中 式 代码 托管 系统 相 比 ， 使 用 Git 每 个 人 都 能 够 独立 工作 ， 并 且 在 自己 本 地 的 仓库 
副本 中 提交 更 改 。 这 意味 着 其 他 开发 者 的 修改 永远 不 会 强制 进入 你 的 作品 。 相 反 ， 你 可 以 
决定 什么 时 候 引 入 外 部 代码 以 及 什么 时 候 共 享 你 的 工作 。 


















































注 1: 由 于 GitHub 页 面 改版 ，Wiki 的 入 口 从 右 侧 边 栏 已 移 至 上 方 的 选项 卡 。 一 一 译 者 注 



































连接 其 他 仓库 

尽管 在 使 用 Git 时 ， 人 们 经 常 提 到 在 没有 网 络 的 飞机 上 编写 代码 这 个 例子 ， 我 
认为 Git 真正 的 优点 在 于 你 可 以 私下 里 更 多 地 尝试 你 的 想法 。 你 可 以 创建 新 
的 分 支 ， 思考 代码 中 的 新 想法 ， 并 且 在 自己 准备 好 了 之 后 再 连接 其 他 仓库 。 
如 果 你 做 过 MBTI 职 业 性 格 测试 (https://en.wikipedia.org/wiki/Myers9%E2% 
809593Briggs Type Indicator), Git 大 概 是 INTP (内 向 /直觉 /理性 /理解 ) 
类 型 的 ， 而 Subversion 大 概 是 ESFJ (SMH / 感觉 /情感 /判断 ) 类 型 的 。 






































每 当 你 开始 使 用 Git 时 ， 对 于 你 的 电脑 来 说 你 使 用 的 是 集中 式 系统 开发 方式 ， 如 图 2-2 所 
示 ， 仓 库 中 的 更 改 全 部 存放 在 你 自己 的 机 器 上 。 你 完成 一 些 工 作 ， 然 后 将 这 些 工作 保存 到 
你 本 地 的 仓库 。 当 你 准备 好 将 工作 共享 给 别人 时 ， 连 接 到 远程 仓库 ， 将 你 特定 分 支 的 副本 
推送 上 去 。 











上 传 已 提交 的 工作 集中 式 代码 更 新 仓库 的 本 地 副本 
托管 系统 


推送 拉 取 


本 地 仓库 未 地 仓库 


© 签 出 
提交 
选择 一 个 分 支 继续 
在 本 地 保存 工作 B 人 分支 继续 工作 


图 2-2: Git 中 的 文件 操作 


把 工作 完全 存放 在 本 地 就 太 大 材 小 用 了 ! 相反 ， 我 们 连接 到 其 他 系统 ， 通 过 远程 仓库 可 以 
共享 我 们 的 代码 。 

Git 不 提供 访问 控制 ， 允 许 任何 开发 者 拥有 仓库 的 完整 读 写 权限 。 在 最 外 层 ， 你 通过 登录 
控制 来 限制 访问 。 我 在 自己 的 机 器 上 开发 ， 而 你 没有 权限 访问 ， 因 此 你 无 法 更 改 我 的 仓 
库 。 一 旦 我 将 仓库 放 在 共享 的 区 域 ， 比 如 集中 式 代码 托管 服务 器 ,我 们 需要 共同 协商 如 何 
管理 仓库 的 访问 权限 。 

一 些 Git 托管 系统 ， 如 Bitbucket， 人 允许 细 粒 度 、 分 支 独 立 的 权限 控制 ， 但是， 大 多 数 托管 
系统 只 允许 你 对 每 个 仓库 设置 访问 控制 。 也 就 是 说 ， 你 要 么 可 以 在 仓库 中 任意 分 支 上 所 
交 ， 要 么 只 能 通过 拉 取 请 求 来 提交 贡献 。 
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在 本 市 中 ,我们 介绍 了 下 面 三 种 最 流行 的 访问 模型 。 

。 单一 仓库 共同 维护 模型 : 团队 中 的 每 个 人 都 是 维护 者 ， 有 权限 向 项 目 仓库 上 传 更 改 。 

。 并 列 贡献 者 仓库 模型 : 提交 贡献 的 开发 者 创建 一 个 项 目的 远程 副本 ， 等 待 项 目 维护 者 接 
受 他 们 的 更 改 。 

。 分 散 页 献 者 仓库 模型 :代码 通过 文本 格式 的 补丁 包 共 享 。 

在 本 市 结束 时 ， 你 会 学 会 如 何 将 这 些 方 法 贯穿 起 来 ， 建立 一 个 适合 你 的 团队 的 访问 模型 。 


2.2.1 适合 分 散 贡 献 者 仓库 的 模型 

当 Git 面世 时 ， 开 源 软件 项 目 通常 在 公开 的 邮件 列表 中 讨论 代码 库 的 更 改 ， 而 不 是 在 集中 
式 网 站 中 。 这 个 模型 如 今 仍 用 于 Git 的 开发 团队 。 这 个 模型 不 太 可 能 适合 你 的 团队 的 开发 ， 
但 是 ， 理 解 这 个 模型 有 助 于 理解 使 用 rebase (第 6 章 ) 和 bisect (第 9 章 ) 命令 时 遇 到 的 
一 些 更 高 级 的 概念 。 

为 了 在 社区 中 共享 工作 ， 开 发 者 需要 使 用 diff 程序 创建 一 个 补丁 文件 。 开 发 者 接 下 来 给 
讨论 组 发 送 一 份 邮件 ， 将 图 2-3 所 示 的 补丁 文件 添加 为 附件 。 为 了 审核 提出 的 更 改 ， 邮 件 
列表 成 员 将 会 下 载 附 件 中 的 补丁 文件 ， 并 使 用 系统 自 带 的 patch 命令 将 更 改 应 用 到 本 地 代 
码 库 。 

通过 邮件 列表 共享 补丁 文件 ， 开 发 者 得 以 隔离 和 贡献 他 们 的 工作 ， 而 通过 有 效 地 限制 补丁 
文件 共享 的 内 容 ， 审 查 者 可 以 轻松 地 看 到 在 共享 代码 库 中 两 个 特定 时 间 点 之 间 的 更 改 。 



































ERARA FI) RE 
为 了 让 邮件 发 送 补丁 文件 更 加 方便 ，Git 增加 了 am 命令 来 支持 通过 邮件 列表 
发 送 的 补丁 。 


这 个 模型 如 今 仍然 被 Git 项 目 自身 使 用 ， 它 仍然 使 用 邮件 列表 来 共享 补丁 ， 并 讨论 哪些 功 
能 应 该 被 加 入 Git， 哪 些 bug 应 该 被 消灭 。 


尽管 这 个 模型 看 上 去 有 些 过 时 ， 但 它 确 实 具 有 以 下 这 些 优点 。 


。 你 不 需要 在 本 地 拥有 特定 的 版 本 控制 系统 ， 因 为 补丁 文件 不 需要 在 本 地 安装 版 本 控制 

软件 。 

开发 者 可 以 轻松 地 使 用 邮件 应 用 来 审查 提出 的 更 改 。 

这 个 模型 鼓励 完整 的 想法 。 如 果 你 每 次 提交 更 改 都 需要 给 一 群 人 发 邮件 ， 你 更 可 能 会 确 

保 所 有 地 方 都 是 正确 的 ， 以 避免 “我 又 想起 一 件 事 ” 的 尴 诊 。 

。 将 你 提出 的 更 改 上 传 到 一 个 单独 的 系统 ， 而 不 是 上 传 到 代码 托管 系统 ， 确 保 让 软件 项 目 
中 的 成 员 来 实施 审查 的 过 程 。 换 言 之 ， 开 发 者 不 能 直接 将 更 改 上 传 到 主 仓库 ， 而 必须 宣 
布 工作 完成 并 等 待 其 他 人 将 它 合 并 。 



























































集中 式 代码 
托管 系统 


本 地 仓库 

















本 地 仓库 
提交 : 
完成 工作 后 ， 将 补丁 j 
提交 评审 
> 


核心 维护 人 员 
à 








到 官方 仓库 





评审 通过 的 补丁 将 会 提交 Hi 


Y 
评审 者 。 ”评审 者 

















图 2-3: 社区 对 补丁 的 审查 过 程 


使 用 分 立 的 仓库 不 仅仅 适用 于 使 用 邮件 列表 沟通 的 项 目 。 在 本 书 编写 时 ，Drupal 项 目 正在 
使 用 这 个 模型 的 一 个 变种 。 与 使 用 邮件 列表 来 共享 补丁 相 比 ，Drupal 项 目 使 用 一 个 自行 管 
理 、 集 中 式 代 码 托管 和 工 单 issue 系统 。 图 2-4 展示 了 一 个 包含 补丁 文件 的 issue 屏幕 截图 。 
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o emmajane commented 5 years ago #84 
Status: Active » Needs review 


Status File Size 
E removing-pleases.patch 4.37 KB 
new Passed: 12875 passes, 0 fails, 0 exceptions 
View | Retest ] 





Just looked at the welcome screen with fresh eyes on a new install. There were three 
"please"s. Patch attached to remove my Canadian-isms. :) 











图 2-4. 一 个 带 有 补丁 文件 的 Drupal issue 队列 


在 这 个 模型 中 ， 你 可 以 在 共享 之 前 为 每 个 提交 署名 ; 但 是 ， 如 果 有 多 人 参与 ， 则 很 难 搞 清 
提交 历史 中 谁 做 了 哪些 更 改 。 团 队 不 得 不 使 用 补丁 格式 政策 〈 不 论 是 否 签署 ) 以 及 一 个 提 
交 消 息 格 式 。Drupal 使 用 了 严格 的 提交 消息 规范 (https:/www.drupal.org/node/52287) 来 确 
保 每 个 人 的 工作 都 被 认可 。 

对 于 现在 开始 的 大 多 数 项 目 来 说 ， 这 个 模型 是 不 合适 的 。 但 如 果 你 将 每 个 提交 视 为 一 个 完 
整 的 想法 ， 这 个 模型 确实 有 助 于 理解 一 些 更 复杂 的 命令 ， 比 如 bisect。 这 个 模型 的 一 个 更 
现代 的 做 法 是 在 单一 的 代码 托管 系统 中 来 派生 、 克 隆 仓 库 。 


2.2.2. ”适合 并 列 贡 献 者 仓库 的 模型 
如 今 ， 软 件 开发 者 不 再 交换 补丁 文件 ， 而 是 通常 使 用 集中 式 代 码 托管 系统 来 帮助 他 们 管理 
打 补 本 的 过 程 。 使 用 单一 的 代码 托管 系统 使 得 在 仓库 间 可 编程 地 创建 和 提交 补丁 变 得 更 加 
容易 。 补 丁 的 管理 方法 是 每 个 版 本 控制 系统 的 独家 秘方 。Git 的 pre-commit 钧 子 确保 在 这 
个 过 程 中 能 够 遵守 访问 控制 。 
在 并 列 的 系统 中 ,“ 上 游 ” 项 目 保留 了 完整 的 控制 ， 决 定 谁 拥 有 项 目 主 仓库 的 写 入 权限 。 
每 个 贡献 者 使 用 代码 托管 系统 将 项 目 克 隆 、 派 生 至 他 们 的 本 地 仓库 。 如 图 2-5 所 示 ， 贡 献 
者 更 改 本 地 的 副本 ， 然 后 通过 合并 请 求 或 拉 取 请 求 提交 这 些 更 改 。 如 果 你 参与 的 开源 项 目 
拥有 很 多 贡献 者 ， 你 最 可 能 使 用 的 就 是 这 个 模型 。 
GitHub 将 这 种 开发 模型 推广 到 了 现在 很 多 的 开源 项 目 中 。 我 见 过 一 些 职能 严格 分 离 的 内 部 
项 目 同样 应 用 了 这 个 模型 。 如 果 QA 团队 专门 负责 将 最 终 的 代码 并 入 稳定 的 预 发 分 支 ， 他 
们 可 能 会 在 这 个 模型 的 基础 上 做 一 些 修改 。 如 果 你 使 用 外 部 承包 商 并 且 不 希望 他 们 越过 审 
查 直接 向 仓库 提交 更 改 ， 那 么 这 个 模型 同样 适合 你 。 
Git 和 GitHub 术语 的 比较 
有 时 候 很 难 知 道 应 该 使 用 哪个 术语 ， 因 为 现在 普遍 采用 的 GitHub 术语 并 
不 总 是 与 对 应 的 Git 命令 保持 一 致 。 比 如 ，GitHub 的 术语 fork 使 用 Git 命 
令 clone 创建 了 一 个 仓库 的 副本 。 因 为 这 本 书 的 重点 是 Git 本 身 ， 而 不 是 
GitHub 的 Git 实现 ， 所 以 我 们 将 会 使 用 Git 命令 。 我 们 偶尔 会 同时 用 到 两 种 
术语 ， 因 为 有 时 我 们 更 熟悉 GitHub 的 术语 ， 而 不 是 单独 的 命令 。 
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Peo 
a à 
官方 仓库 E 
和 
ER 





克隆 














图 2-5: 创建 一 个 克隆 仓库 
当 GitHub 创建 一 个 派生 的 仓库 时 





， 它 等 同 于 使 用 Git 命令 clone 来 创建 一 个 仓库 的 副本 。 





一 旦 你 创建 了 一 个 派生 仓库 ， 你 就 可 以 在 GitHub 的 网 页 上 直接 将 更 改 应 用 于 仓库 ， 但 对 
于 比较 复杂 的 更 改 来 说 ， 这 不 是 一 个 好 习惯 。 相 比 之 下 ， 你 更 有 可 能 会 再 克隆 一 次 仓库 ， 


而 这 次 是 从 派生 出 来 的 仓库 克隆 至 


命令 会 少 


m 


到 另 一 个 的 克隆 链 。 保 持 所 有 仓库 同步 有 些 费 寻 
很 多 。 正 所 谓 “ 有 得 有 失 。 





I 本 地 的 工作 区 。 这 个 做 法 高 效 地 建立 了 从 一 个 仓库 副本 
了 ， 但 是 ， 与 直接 操作 补丁 相 比 ， 需 要 记忆 














架构 相同 的 仓库 应 该 比分 立 的 仓库 更 易于 使 用 ， 因 为 你 使 用 封装 软件 更 加 方便 。 除 了 让 更 


新 工作 更 为 方便 之 儿 


\， 封 装 软件 使 


F> A 
小 用 


够 更 有 效 地 控制 谁 能 够 提交 工作 并 获得 认可 。 


一 般 来 说 ， 克 隆 链 中 的 第 一 个 仓库 应 该 只 能 被 少数 核心 提交 者 改变 ， 他 们 有 权限 向 仓库 中 


添加 新 的 提交 或 合 关 
本 地 的 克隆 仓库 中 ， 
码 ， 并 将 工作 推送 到 








| 3:5: ERAT 


F 分 支 。 大 多 数 项 目的 参与 者 将 会 从 仓库 的 本 地 克隆 开始 工作 。 在 这 个 
每 个 人 都 拥有 完整 的 控制 权限 。 他 们 可 以 添加 新 的 分 文 、 添 加 新 的 代 














F 殉 隆 仓库 ， 将 提出 的 更 改 共享 给 别人 。 一 旦 工作 被 推送 

















到 了 公共 的 克隆 仓 库 ， 编 写 者 可 以 请 求 社区 对 最 新 工作 进行 反馈 。 一 旦 工作 被 











t 
E 





审查 完成 并 








由 社区 测试 之 后 ， 编 写 者 可 以 发 起 一 个 从 公开 的 克隆 仓库 到 主 仓库 的 合并 请 求 或 拉 取 请 求 。 
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如 果 某 人 不 打算 让 他 们 的 工作 贡献 回 


F, E 
还 做 了 


不 过 ， 


zh OC iS 




















到 主 仓库 ， 他 们 可 以 跳 过 创建 公开 的 克隆 仓库 这 一 


接 将 主 仓库 克隆 至 本 地 环境 。 如 采 你 意识 到 有 一 些 更 改 需 要 提交 回 到 项 目 中 ,， 并且 


一 些 不 希望 被 共享 的 工作 时 ， 事 情 会 变 得 有 些 麻烦 。 











认识 到 你 做 的 事 能 帮 到 别人 并 不 总 是 那么 容易 的 。 比 如 ， 我 正在 使 用 一 个 开源 的 演 








EŻ reveal.js (https://github.com/hakimel/reveal.js) 为 OSCON 制作 幻灯 片 。 对 你 来 


说 ， 你 可 能 正在 使 用 一 个 WordPress 主题 ， 或 是 一 个 前 端 框架 ， 或 是 其 他 的 起 始 模板 。 

以 前 在 使 用 reveal.js 制作 幻灯 片 时 ， 我 觉得 我 不 会 在 使 用 时 升级 reveal.js 软件 ， 若 停 下 来 
升级 ， 我 会 担心 与 上 游 项 目的 Git 连接 是 否 还 存在 。 我 在 自己 的 仓库 中 翻 遍 了 所 有 文件 夹 ， 
我 的 工作 才 得 以 完成 。 一 个 自 定 义 的 主题 完成 了 ， 我 做 了 一 些 修改 ， 我 的 仓库 变 成 了 一 





个 派生 仓库 ， 和 它 的 起 点 不 有 



































了 相连 。( 有 开源 项 目 经 验 的 开发 者 这 时 会 抓 狂 ， 因 为 他 们 已 


经 意识 到 了 我 即将 发 现 的 事 。) 当 我 开始 工作 时 ， 我 发 现 幻 灯 片 排版 成 讲义 时 出 现 了 格式 
我 希望 我 的 演讲 者 备注 能 显示 在 幻灯 片 的 旁边 (https://github.com/hakimel/reveal.js/ 


错误 ， 


pull/963), ， 而 不 是 堆积 在 下 方 。 我 在 项 目的 GitHub 页 


















































而 上 创建 了 一 个 bug 报告 ， 然 后 继续 





工作 。 有 些 人 给 了 我 一 些 重新 排版 的 建议 。 啊 ! 我 知道 怎么 解决 这 个 问题 了 。 我 想 我 的 问 
解决 了 ， 但 其 他 人 仍然 有 可 能 对 我 的 解决 方案 感 兴趣 。 现 在 我 陷入 了 两 难 的 境地 ， 


题 已 经 
我 创建 

















自己 的 项 目 时 并 没有 打算 共享 我 的 工作 。 




















如 果 你 提交 了 一 个 补丁 ， 你 或 许可 以 只 共享 部 分 工作 ， 但 当 你 和 并 列 贡献 者 一 起 工作 
需要 通过 已 有 的 仓库 将 你 的 工作 共享 回去 。 我 自己 的 项 目 没 有 为 上 游 的 工作 准备 分 


时 ， 你 
支 ， 因 








为 我 从 来 设想 过 要 将 我 的 工作 共享 回 这 个 演示 文稿 

















链 。 [E 


2-6 显示 了 我 操作 的 顺序 。 在 GitHub E, REE T 





E 架 。 我 开始 创建 一 个 新 的 仓库 
reveal.js 主 项 目的 一 个 派生 仓库 











(https://github.com/emmajane/reveal.js)。 然 后 我 将 派生 的 仓库 克隆 到 本 地 。 我 在 本 地 的 克隆 
仓库 中 为 我 的 更 改 创建 了 一 个 新 的 分 支 。 之 后 我 将 这 些 更 改 从 OSCON 的 幻灯 片 中 (因为 


只 有 很 























少 的 幻灯 片 ， 所 以 我 不 介意 打 一 个 补丁 ， 我 只 要 用 我 习惯 的 复制 粘贴 工具 即 可 ) EE 


制 到 克隆 的 演示 文稿 框架 的 仓库 。 当 更 改 完成 时 ， 我 将 更 改 推送 回 GitHub 上 的 远程 仓库 ， 


并 且 创 


reveal.] 


和 确认 ， 即 开发 者 是 受信 任 的 。 在 这 个 模型 中 ， 在 推送 至 项 目 共 享 的 仓库 之 前 ， 
者 在 本 地 完成 自己 的 工作 。 如 图 2-7 所 示 ， 与 内 部 团队 协作 时 ， 我 们 的 起 点 通常 是 单个 共 





3:896; 


建 拉 取 请 求 将 我 的 更 改 并 入 项目 。 








s 仓库 公开 的 克隆 是 必需 的 ， 因 为 我 没有 revealjs 仓库 的 写 和 权限。 如 果 我 有 写 入 
权限 ， 我 可 以 不 必 创 建 公 开 的 克隆 仓库 ， 直 接 创建 一 份 本 地 的 克隆 仓库 。 
2.2.3 共同 维护 的 模型 


最 后 ， 我 们 会 介绍 内 部 团队 (和 个 人 团队 ) 中 最 常见 的 权限 模型 : 共同 维护 。 在 这 个 模型 
中 ， 团 队 成 员 之 间 有 着 天 生 的 信任 。 我 们 假设 代码 在 提交 至 主 项 目 分 支 之 前 已 经 经 过 检查 
































库 ， 每 个 人 都 拥有 对 该 仓库 的 共享 写 入 权限 。 














每 个 开发 












































GitHub 
a 4 
reveal.js 的 官方 revealjs 仓 库 的 
仓库 个 人 派生 副本 
回 派生 项 目 拉 取 请 求 d 
[1 克隆 远程 仓库 
[V] 在 本 地 创建 一 个 新 的 分 支 
M 签 出 这 个 新 分 支 推送 
M 编辑 文件 ， 同 步 OSCON 的 CSS 
回 提 交 新 的 CSS 修 改 
将 分 支 推 送 到 克隆 的 远程 仓库 
回 提交 一 个 拉 取 请 求 Eo ug 
| E^ 3 reveal.js 仓 库 的 
本 地 克隆 
\ E d 
提交 











2-6: 并 列 仓库 之 间 的 项 目 更 改 流向 


Git 不 提供 权限 控制 ， 而 是 依赖 其 他 系统 来 授权 或 阻止 对 项 目的 写 和 访问。 如果 你 想 要 阻 
止 别人 将 代码 上 传 至 共享 仓库 ， 需 要 使 用 托管 系统 的 访问 控制 才能 实现 。 如 果 你 使 用 的 托 
管 平台 并 非 Git， 那 么 访问 可 能 由 SSH 账户 管理 。 

除 此 之 外 ， 与 Subversion 不 同 ，Git 不 允许 你 锁定 特定 的 分 支 。 如 果 不 借助 额外 的 软 
件 ， 团 队 成 员 默 认 在 充分 测试 之 前 不 会 将 更 改 提交 到 特定 分 支 。Bitbucket (第 11 章 ) 和 
GitLab (第 12 章 ) 提供 了 分 支 独立 的 访问 限制 。 如 果 你 倾向 于 使 用 一 个 更 加 轻 量 的 系统 ， 
可 以 看 一 看 Gitolite (http://gitolite.com/gitolite/index.html) 。 
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集中 式 代码 托管 系统 











本 地 仓库 
签 出 1 Ns 

















图 2-7. 团队 中 每 个 成 员 都 拥有 从 本 地 仓库 向 中 央 仓 库 写 入 的 权限 


2.2.44 自 定 义 访问 模型 


除了 这 些 策略 之 外 ， 团 队 还 可 以 为 一 个 项 目 选择 多 个 访问 模型 。 官 方 仓库 的 代码 提交 有 着 
严格 规定 的 项 目 ， 这 个 模型 将 会 特别 有 用 。 确 实 ， 大 多 数 开源 项 目 对 不 同 的 贡献 者 提供 了 





不 同 的 访问 权限 。 
一 个 常见 的 工作 流 如 下 所 示 。 

















。 一 个 官方 项 目 仓 库 ， 只 有 极 少 数 人 可 以 向 该 仓库 提交 代码 。 在 开源 项 目 中 ， 这 个 角色 即 
项 目 维护 者 ， 在 闭 源 或 合作 的 项 目 中 ， 这 个 角色 可 能 是 QA 团队 。 





。 一 份 限制 更 为 宽松 的 仓库 内 部 副本 ， 每 个 贡献 者 和 项 目 














团队 都 使 用 该 副本 进行 集成 。 这 


个 仓库 或 许 会 遵循 共同 维护 的 模型 ， 作 为 代码 审查 流程 中 的 一 环 ， 每 个 人 都 可 以 将 他 们 


的 分 支 并 入 仓库 ， 其 至 在 一 个 特定 的 起 点 上 继续 开发 。 


。 锁定 到 各 个 贡献 者 的 单独 创建 的 个 人 仓库 。 通 常 这 些 仓库 会 使 用 与 官方 仓库 相同 的 代码 
托管 系统 ,因为 大 多 数 现代 代码 托管 系统 都 拥有 易于 集成 的 功能 (通常 称 为 “ 拉 取 请 求 ” 





或 “合并 请 求 ”)。 














这 种 项 目 组 织 方式 常见 于 拥有 初级 开发 者 、QA 团队 或 者 也 许 有 外 部 承包 商 的 团队 。 


第 4 章 将 更 深入 地 讲解 常见 的 工作 流 。 





2.3 小 结 
在 本 章 中 ， 你 学 到 了 授权 和 限制 访问 项 目 仓库 的 各 各 方式。 


。 清晰 地 定义 项 目 治 理 模型 将 有 助 于 所 有 贡献 者 理解 项 目的 所 有 权 。 

。 代码 的 版 权 通 第 属 于 作者 ， 除 非 因 为 贡献 者 协议 或 作为 雇用 作品 将 版 权重 新 分 配给 另 一 
个 法 人 。 

。 限制 分 发 及 代码 衍生 品 的 规则 由 软件 许可 证 决定 。 

。 Git 只 是 一 个 简单 的 内 容 跟踪 工具 ， 它 不 提供 开 箱 即 用 的 控制 机 制 。 一 些 代码 管理 系统 
整合 了 pre-commit 钧 子 ， 用 来 限制 分 支 独立 时 的 访问 。 

。 任意 仓库 的 访问 可 以 是 受 限 的 ， 也 可 以 是 开放 的 。 提 交 至 仓库 的 更 改 由 补丁 组 成 。 在 代 
码 托管 系统 中 ， 你 可 以 使 用 图 形 化 界面 来 管理 补丁 提交 流程 。 


仓库 中 的 权限 结构 已 经 搭建 完成 ， 我 们 接 下 来 将 会 探索 如 何 分 隔 仓 库 ， 让 你 正在 进行 的 工 
作 和 已 经 完成 的 工作 都 可 以 在 团队 成 员 之 间 共 享 。 






















































































命令 与 控制 | 25 


第 3 章 


分 支 策 略 





在 版 本 控制 中 ,分 支 用 于 隔离 一 块 代码 上 产生 的 不 同 想 法 。 分 支 总 是 起 源 于 代码 库 中 的 某 
个 特定 市 点 。 在 第 2 章 中 我 们 谈 到 了 派生 和 克隆 仓库 。 分 支 类 似 于 新 工作 开始 时 仓库 内 部 
的 分 隔 。 创 建 分 支 时 你 可 能 想 要 将 工作 贡献 回去 ， 也 可 能 想 要 隔离 不 同 的 工作 。 分 支 本 身 
并 不 关心 跟踪 的 是 什么 更 改 ! 它们 的 职责 仅仅 是 跟踪 更 改 。 


使 用 什么 分 支 策略 取决 于 你 的 发 布 管理 流程 。 分 支 允许 你 更 改 项 目 工作 目录 中 可 见 的 文件 ， 
并 且 一 次 只 会 有 一 个 分 支 活跃 。 大 多 数 分 支 策略 是 根据 粗 粒度 的 想法 分 隔 项 目 中 的 工作 。 
这 个 想法 可 以 是 软件 的 版 本 ， 比 如 ， 版 本 1、 版 本 2、 版 本 3。 这 些 软件 版 本 或 许 能 使 你 联 
想到 分 支 上 正在 进行 的 工作 。 根 据 它们 代表 的 功能 名 称 ， 这 些 想法 被 分 隔 在 不 同 分 支 。 这 
些 想法 可 能 是 一 个 bug 修复 或 是 一 个 新 的 功能 ， 但 它们 也 可 以 表示 一 个 完整 的 小 想法 。 

本 章 概述 了 以 下 内 容 。 

。 如 何 为 你 的 团队 选择 一 种 分 支 约定 

。 主线 开发 

。 功能 分 支部 署 

NE E: 

。 计划 部 团 

分 支 的 使 用 方式 没有 任何 限制 。 这 既是 好 事 ， 又 是 坏事 。 一 些 人 为 的 限制 (约定 ) 将 会 帮 
助 你 考虑 团队 的 无 限 可 能 。 


3.1 理解 分 支 


无 需 研究 Git 内 部 的 工作 原理 ， 基 本 理解 了 分 支 的 概念 就 能 够 帮助 你 挑选 并 应 用 本 章 概述 
的 策略 。 
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每 个 Git 仓库 都 包含 一 个 提交 库 。 这 些 提交 通过 元 数据 相互 链接 ， 每 个 提交 包含 一 个 指向 
自身 父 提交 的 引用 。 对 于 合并 提交 (merge commit) 而 言 ， 它 可 能 会 引用 不 止 一 个 父 提 交 。 
我 通常 把 分 支 比 作 珠 串 ， 每 个 提交 代表 串 上 的 一 颗 珠 子 。 这 个 比喻 不 是 那么 严 说， 不 过 很 
好 地 说 明了 我 们 的 意图 。Git 中 的 分 支 实际 上 是 一 个 指向 某 个 特定 提交 的 命名 指针 。( 给 你 
一 根 魔 棒 ， 边 说 名 字 边 敲 一 颗 珠 子 。 你 创建 了 一 个 命名 分 支 。) 当 你 签 出 分 支 时 ， 你 将 提 
交 对 象 ( 由 指针 标识 ) 中 储存 的 数据 复制 到 你 的 工作 目录 。 在 工作 被 复制 到 工作 目录 后 ， 
你 可 以 进行 任何 操作 〈 新 增 、 编 辑 和 删除 文件 ) ， 并 且 将 更 改作 为 一 个 新 的 提交 对 象 储存 
到 本 地 仓库 。 命 名 指针 会 自动 更 新 并 指向 你 刚 创 建 的 提交 对 象 ， 同 时 你 的 分 支 也 将 更 新 。 


你 创建 的 任何 提交 对 象 都 是 本 地 的 ， 并 且 只 属于 你 ， 直 到 你 选择 主动 将 它们 共享 到 一 个 远程 
仓库 。 这 一 点 Git 和 集中 式 版 本 控制 模型 完全 不 同 ， 后 者 提交 更 改 时 工作 会 被 自动 上 传 。 对 
于 一 些 可 能 出 现 的 冲突 ， 只 需 记 住 每 个 开发 者 在 自己 的 仓库 中 都 有 一 根 魔 棒 ， 拥 有 全 部 能 力 。 


开发 者 创造 了 关于 命名 分 支 和 使 用 分 支 的 约定 来 避免 冲突 。 这 些 约定 帮助 开发 者 决定 在 什 
么 情况 下 允许 工作 出 现 偏离 (创建 新 的 分 支 )， 以 及 什么 时 候 合并 (合并 两 个 或 多 个 分 支 
中 的 提交 对 象 )。 一 般 来 说 ， 一 种 约定 包含 了 两 类 分 支 : 长 期 活跃 的 公开 分 支 ， 短暂 的 私 
有 分 支 。 长 期 活跃 的 分 支 扮演 了 代码 中 介 的 角色 ， 并 和 人 大 量 开发 者 的 贡献 。 短 暂 的 分 支 的 
作用 是 隔离 一 个 新 想法 的 开发 过 程 。 这 些 新 想法 可 以 是 一 个 bug 修复 、 新 增 功能 或 实验 性 
的 重 构 。 这 完全 取决 于 你 ! 


当 你 和 其 他 人 共享 分 支 时 ， 你 可 以 继续 在 你 的 分 支 副 本 上 添加 提交 对 象 ， 但 是 ， 既 然 分 支 
已 经 被 共享 ， 可 能 其 他 人 也 在 他 们 的 分 支 副 本 上 添加 了 提交 对 象 。 当 你 下 次 想 要 同步 这 两 
个 分 支 时 ，Git 作为 纯粹 的 内 容 跟踪 者 ， 会 转 而 借助 你 的 经 验 来 将 这 两 份 提交 对 象 合并 到 
一 个 共享 的 历史 。 自 动 化 流程 中 的 这 个 中 断 称 为 合并 冲突 (merge confict) 。 我 承认 它 听 上 
去 有 些 吓 人 。 你 的 任务 是 解决 冲突 并 为 有 问题 的 工作 选择 最 合适 的 共享 历史 。 


在 3.4 市 中 ， 你 将 会 学 到 保持 分 支 最 新 的 策略 。 在 第 7 章 中 ， 你 将 学 到 一 些 实用 的 命令 。 
第 7 章 同 时 介绍 了 如 何 解决 冲突 。 不 过 ， 让 我 们 先 来 看 一 看 开发 者 在 Git 中 维护 工作 时 ， 
一 些 最 常用 的 分 文 命名 策略 。 


3.2 ”挑选 约定 


约定 是 大 家 认同 如 何 做 一 件 事 的 标准 。 作 为 开发 者 ， 约 定 让 我 们 能 够 快速 了 解 一 个 软件 项 
目 是 如 何 运 转 的， 并 且 在 整合 自己 的 工作 时 不 影响 其 他 团队 成 员 的 流程 。 形 成 文档 的 约定 
让 新 参与 者 更 加 容易 上 手 ， 而 其 他 团队 成 员 现 在 只 需 花 费 更 少 的 工作 时 间 来 帮助 新 人 。 


为 团队 挑选 合适 的 分 支 策 略 ， 需 要 成 员 们 共同 讨论 希望 如 何 发 布 你 们 的 工作 成 果 。( 从 现 
在 开始 ， 我 将 使 用 “软件 ”来 指 代 你 的 项 目 ， 尽 管 Git 也 可 以 用 于 其 他 事情 ， 比 如 写 书 ! ) 
对 于 网 站 来 说 ， 你 或 许 会 希望 每 天 安排 一 次 发 布 ， 但 对 于 可 下 载 的 软件 产品 ， 你 或 许 会 希 
望 每 个 月 、 每 个 季度 甚至 每 半年 安排 一 次 发 布 。 一 旦 确定 如 何 发 布 软件 以 及 是 否 有 审计 或 
跟踪 的 需求 ， 你 就 可 以 挑选 一 个 最 合适 的 分 支 策略 。 

如 果 你 已 经 了 解 工 作 方式 ， 那 么 先 花 些 时 间 整 理 一 下 你 的 需求 ， 然 后 再 深入 研究 细节 并 选 
择 一 个 最 合适 的 分 支 策略 。 如 果 你 不 确定 你 们 的 系统 会 是 什么 样 的 ， 第 4 章 将 会 给 你 一 些 
关于 如 何 组 织 团 队 内 部 行为 的 建议 。 
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只 要 你 的 团队 将 手头 的 工作 形成 文档 即 可 ， 就 不 需要 再 制定 硬性 规定 。 事 实 上 ， 如 果 你 
查阅 儿 个 开源 项 目的 仓库 ， 就 会 看 到 没有 一 成 不 变 的 做 法 。 我 推荐 使 用 GitHub 镜像 来 比 
较 Drupal (https://github.com/drupal/drupal)、Git (https://github.com/git/git) 和 Sass (https:// 
github.com/sass/sass) 使 用 的 分 支 策略 。 这 三 个 非常 流行 的 项 目 使 用 了 截然 不 同 的 分 支 策略 。 


不 会 有 版 本 控制 警察 站 在 你 门 前 告诉 你 做 错 了 ， 况 且 你 也 总 是 能 找到 另 一 个 与 你 风格 相近 
的 团队 。 但 如 果 你 刚 接触 版 本 控制 ,或 者 你 的 团队 苦于 寻找 平稳 进展 的 办 法 ， 选 择 本 章 介 
绍 的 约定 或 许 能 够 帮助 你 。 


3.3 几 种 约定 


对 于 软件 项 目 来 说 ， 团 队 通常 有 两 种 方式 可 供 选 择 : 要 么 选择 “优先 合并 ， 要 么 查 对 完 
成 的 工作 并 一 次 性 发 布 。 介 于 这 两 个 极端 之 间 有 很 多 不 同 的 工作 方式 。 

本 市 概述 如 今 开发 团队 最 常 使 用 的 一 些 策略 。 你 可 以 选择 完整 地 采取 其 中 一 种 策略 ， 也 可 
以 根据 你 的 需求 来 调整 。 不 管 你 选择 什么 策略 ， 记 得 把 你 的 决定 形成 文档 。 


3.3.1 主线 分 支 开 发 

主线 分 支 开 发 是 最 容易 理解 的 分 支 策略 。 在 这 个 策略 中 只 有 少量 分 支 。 开 发 者 总 是 将 他 们 
的 工作 提交 到 一 个 中 央 分 支 ， 这 个 分 支 随 时 可 部 署 。 换 名 话说 ， 项 目的 主 分 支 应 该 只 包含 
经 过 测试 的 工作 ， 并 且 绝 不 应 该 被 破坏 。 

我 通常 独自 参与 一 些 不 怎么 需要 使 用 版 本 控制 的 业余 小 项 目 ， 比 如 为 杂志 写 稿 。 如 图 3-1 
所 示 ， 在 这 些 情况 下 ， 我 把 所 有 工作 提交 到 默认 分 支 (在 Git PRH master) 。 如 果 我 同时 
进行 着 两 个 不 相关 的 想法 ， 我 可 能 会 偷懒 一 起 提交 ， 或 者 保存 (stash) 一 些 工作 供 日 后 使 
用 。 对 于 这 些 简单 的 项 目 来 说 ， 即 使 不 将 想法 分 隔 在 不 同 分 支 ， 也 能 高 效 地 工作 。 
























































当前 





最 早 的 提交 对 象 


以 前 











93-1: 主线 分 支 开发 : 将 所 有 提交 保存 在 一 个 分 支 
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阅读 链 式 图 

图 上 的 每 个 圆圈 代表 Git 仓库 中 一 个 可 淹 及 的 提交 。 “ 链 式 ”提交 图 的 学 名 叫 
作 有 向 无 环 图 (DAG)。 我 敢 保 证 没有 人 会 考 你 是 否 记 住 了 这 个 名 称 。 但 你 
若 想 进一步 探讨 ， 这 会 是 一 个 很 有 用 的 术语 。 






































随 着 项 目 成 熟 ， 会 不 断 出 现 更 多 需要 考虑 的 地 方 ， 跟 踪 想 法 也 会 变 得 越 来 越 困 难 。 如 果 我 
想 要 尝试 项 目 未 来 的 方向 ， 而 这 些 想 法 还 不 如 当前 其 他 工作 那么 完善 时 ， 我 就 会 开始 添加 
新 的 分 支 。 我 可 能 会 扩大 团队 ， 像 图 3-2 中 一 样 ， 让 一 两 个 评审 者 负责 他 们 自己 的 独立 分 
支 。 当 项 目 (以 及 团队 成 员 ) 逐渐 成 长 时 ， 分 支 的 数量 也 会 逐渐 增长 。 但 这 些 分 支 不 会 同 
时 保持 活跃 。 正 如 《金发 寻 娘 和 三 只 熊 》 中 的 故事 ， 你 的 团队 可 能 会 觉得 一 定数 量 的 分 支 
类 型 “不 多 不 少 正 好 ”。 每 个 工作 单元 [或 者 冲刺 (sprint)] 中 的 分 支 数 量 可 能 会 存在 手 风 
琴 效 应 。 起 初 ， 开 发 者 都 在 做 自己 的 工作 ， 而 分 支 的 数量 随 之 增长 。 后 来 ， 当 每 个 开发 者 
完成 自己 的 工作 并 将 更 改 与 其 他 人 整合 后 ， 分 支 数量 又 降 了 下 去 。 






































包含 其 他 编辑 者 更 改 的 分 支 





主 分 支 Novella Joe Christophe 

















图 3-2: 使 用 分 支 的 主线 开发 : 分 支 隔离 了 多 人 贡献 的 工作 
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使 用 单一 工作 分 支 的 做 法 被 自动 化 构建 过 程 的 团队 大 量 应 用 。 


为 持续 部 署 的 团队 提供 的 建议 

寺 续 集成 是 指 所 有 开发 者 每 天 多 次 将 自己 的 工作 并 入 项 目 主线 的 实践 。 持 续 
交付 是 指 自动 进行 从 开发 者 的 本 地 工作 站 到 服务 器 的 中 间 步 又 (但 不 是 通过 
自动 化 的 流程 来 部 署 ) 的 实践 。 持 续 部 署 的 自动 化 最 为 完备 ， 因 为 所 有 代码 
通过 一 系列 测试 后 ， 直 接 进入 产品 服务 器 。 











将 工作 定期 并 入 中 央 分 支 ， 但 偶尔 进行 部 署 ， 这 样 的 做 法 或 许 适合 你 的 团队 。 在 开始 收集 
工作 后 ， 你 需要 将 本 地 的 工作 和 产品 服务 器 上 的 工作 区 分 开 来 。 如 果 所 有 代码 都 是 可 部 署 
的 ， 那 么 添加 一 个 小 的 修复 然后 立即 发 布 不 是 什么 难事 。 但 如 果 你 提交 到 仓库 中 的 更 改 只 
进行 了 一 半 呢 ? 因此 ， 我 们 不 再 使 用 纯粹 的 持续 部 署 策略 ， 而 是 使 用 多 个 分 支 的 计划 部 署 
策略 。 


使 用 辟 励 持续 集成 工作 的 分 支 策 略 有 以 下 优点 。 


。 整个 项 目 中 不 会 出 现 很 多 分 支 。 因 此 ， 一 项 更 改 的 消失 不 会 造成 明显 的 困惑 。 

。 并 入 代码 库 的 提交 相对 较 小 。 如 果 发 现 了 问题 ， 能 够 相对 更 快 地 撤销 错误 。 

。 紧急 修复 会 变 得 更 少 ， 因 为 主 分 支 中 的 代码 都 是 达到 部 署 标准 的 。 部 署 对 于 开发 者 往往 
都 是 压力 重重 的 ， 他 们 紧张 地 看 着 代码 进入 产品 然后 等 待 用 户 的 反馈 。 经 过 频繁 的 小 幅 
更 新 ， 这 个 流程 慢 慢 成 熟 并 最 终 自 动 化 ， 终 端 用 户 几 乎 感受 不 到 。 


使 用 这 个 策略 也 有 下 面 这 些 缺 点 。 


。 这 个 策略 的 前 提 是 主 分 支 中 只 包含 随时 可 部 署 的 代码 。 如 果 你 的 团队 缺乏 测试 设施 ， 腊 
想 新 的 代码 不 会 有 问题 就 过 于 冒险 了 ， 尤 其 是 在 项 目 随 着 时 间 变 得 越 来 越 复杂 的 时 候 。 

。 部 署 这 个 概念 更 适合 指 自动 装载 到 用 户 设备 (如 网 站 ) 的 代码 。 对 于 必须 手动 下 载 和 安 
装 的 软件 来 说 ， 这 个 术语 不 是 那么 合适 。 尽 管 修复 问题 的 更 新 总 是 受 欢 迎 的 ， 但 如 果 让 
我 每 天 在 手机 上 下 载 并 重新 安装 一 个 应 用 ， 我 也 会 感到 不 悦 。 

。 开发 者 验证 产品 代码 的 方法 之 一 是 将 功能 隐藏 在 一 个 开关 后 。 据 说 Facebook, Flickr 和 
Etsy 都 使 用 了 这 个 方法 。 不 过 ， 这 个 方法 存在 的 淤 在 风险 是 ， 隐 藏 在 开关 后 的 代码 可 能 
会 被 废弃 ， 因 为 被 隐藏 而 未 被 及 时 移 除 的 代码 会 导致 技术 债务 堆积 如 山 。 

不 幸 的 是 ， 介 绍 如 何 搭建 持续 部 署 的 基础 设施 超出 了 本 书 的 范围 ， 因 为 这 依赖 于 你 所 使 用 

的 语言 (不 同 语言 拥有 自己 不 同 的 测试 库 ) 和 部 署 工 具 。 如 果 你 希望 了 解 有 关 理念 的 更 多 

A, Jez Humble 和 David Farley 的 《持续 交付 : 发布 可 靠 软件 的 系统 方法 》' 是 一 本 很 好 

的 入 门 书 。 


3.8.2 功能 分 支部 署 


为 了 克服 刚才 提 到 的 单 分 支 策略 的 限制 ， 你 可 以 引入 两 种 类 型 的 分 文 : 功能 分 支 和 集成 分 
支 。 严 格 地 说 ， 它 们 不 是 两 种 类 型 的 分 支 ， 而 是 依据 每 个 分 支 的 职能 来 区 分 的 约定 。 
































































































































注 1: 此 书 已 由 人 民 邮 电 出 版 社 出 版 。 一 一 编者 注 









































在 使 用 功能 分 支 的 部 署 策 略 中 ， 所 有 新 的 工作 都 在 一 个 功能 分 支 上 完成 ， 这 个 分 支 小 到 恰 
好 能 够 容纳 一 个 完整 的 想法 。 这 些 分 支 通过 一 个 集成 分 支 与 其 他 开发 者 完成 的 工作 保持 同 
步 。 等 到 软件 发 布 前 ， 构 建 管理 员 可 以 挑选 将 哪些 功能 集成 到 这 个 版 本 ， 并 为 部 署 创建 一 
个 新 的 集成 分 支 。 如 图 3-3 所 示 ， 一 次 构建 不 一 定 会 包含 上 次 构建 之 后 所 有 完成 的 工作 。 









































tox 集成 分 支 功能 1 功能 2 





假设 功能 1 和 功能 2 配合 恨 
好 : 将 集成 分 支 中 的 更 改 < "CIE 
一 同 并 入 主 分 支 。 
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图 3-3. 功能 分 支部 署 : 功 能 分 支 之 间 通 过 集成 分 支 保持 同步 


添加 多 个 功能 分 支 和 一 个 集成 分 支 后 ， 你 可 以 保证 代码 一 直 古 可 部 署 的 ， 但 在 部 署 代码 前 也 
会 停顿 一 下 。 这 个 模型 最 流行 的 描述 是 Adam Dymitruk (http://dymitruk.com/blog/2012/02/05/ 
branch-per-feature/) 提出 的 ， 其 更 早 一 些 的 描述 由 Scott Chacon 提出 并 被 命名 为 GitHub 流 
程 (http://scottchacon.com/2011/08/31/github-flow.html)。 经 过 了 几 次 微调 (https://twitter.com/ 
emmajanehw/status/519814560539480064) 后 ， 这 个 流程 如 今 仍然 被 GitHub 使 用 。 


在 GitHub 流程 的 分 支 模 型 中 ， 任 何 master 分 支 上 的 代码 都 是 可 部 署 的 。 当 编写 新 的 代码 
时 ，GitHub 流程 要 求 开 发 者 创建 一 个 语义 化 命名 的 分 支 ， 并 将 他 们 的 工作 定期 提交 到 这 个 
分 支 。 这 个 分 支 与 master 同步 ， 并 定期 推送 到 共享 仓库 中 对 应 的 分 支 ， 使 得 其 他 人 可 以 看 
到 哪些 功能 正在 进行 。 当 开发 者 认为 工作 已 经 完成 ， 或 者 需要 其 他 人 的 帮助 时 ， 他 们 会 在 
master 分 支 上 发 起 一 个 拉 取 请 求 。 工 单 系统 将 会 出 现 关 于 工作 方案 的 讨论 。 


到 目前 为 止 ，GitHub 流程 和 Dymitruk 模型 几乎 是 相同 的 。 它 们 的 区 别 在 于 部 署 方 式 。 在 
Dymitruk 模型 中 ， 创 建 一 个 构建 前 需要 挑选 即将 集成 的 功能 。 在 GitHub 流程 模型 中 ， 在 合 
并 请 求 被 接受 后 ， 即 可 从 功能 分 支 上 立即 部 署 工作 ， 在 这 个 意义 上 ， 这 种 策略 更 接近 于 主线 
开发 。 早 先 ，GitHub 将 自己 的 功能 分 支 并 入 master 分 支 ， 然 后 再 部 署 master 分 支 。 现 在 ， 我 
们 部 署 完 功能 分 支 ， 如 果 上 面 没 有 错误 ， 它 将 被 并 入 master 分 支 ， 如 图 3-4 所 示 。 也 就 是 说 ， 
如 果 功 能 分 支 存在 问题 ， 我 们 可 以 立即 重新 部 署 master， 因 为 这 个 分 支 永 远 处 于 工作 状态 。 
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图 3-4; GitHub 流程 功能 分 支 在 审查 后 进行 部 署 ， 然 后 被 并 入 到 master 分 支 中 

使 用 功能 分 支部 署 策略 有 以 下 两 个 优点 。 

。 类 似 于 主线 开发 ， 我 们 力图 让 代码 快速 持续 部 署 。 

。 区 别 于 主线 开发 ， 我 们 提供 一 个 可 选 的 构建 步 驼 。 当 使 用 构建 步骤 时 会 出 现 一 个 选项 ， 
用 于 选择 应 该 将 哪些 功能 并 入 到 master 分 支 中 进行 部 署 。 


同样 ， 使 用 功能 分 支部 署 策 略 有 以 下 三 个 缺点 。 


。 如 果 代 码 存放 在 功能 分 支 上 ， 而 不 是 立刻 发 布 到 master 分 支 ， 开 发 者 需要 进行 额外 的 
维护 ， 保 证 在 将 代码 并 入 部 署 分 支 前 ， 功 能 都 保持 最 新 。 

。 分 支 的 语义 化 命名 对 于 熟悉 系统 的 开发 者 有 帮助 ， 但 如 果 进 行 中 的 功能 很 多 ， 新 参与 者 
会 对 这 些 行 话 感到 困惑 。 

。 开发 者 需要 定期 清理 那些 已 经 并 入 master 分支 的 遗留 分 支 。 这 不 算 麻 烦 ， 但 与 在 单一 
的 master 分 支 上 工作 ， 需 要 这 个 额外 的 步骤 。 


功能 分 支 策略 提供 了 一 个 介 于 主线 开发 和 计划 部 署 之 间 的 过 渡 状 态 。 在 某 种 程度 上 ， 计 划 
部 署 扩展 了 这 个 策略 ， 但 使 用 了 特殊 的 命名 约定 。 


3.3.3 ”状态 分 支 


和 之 前 提 到 的 策略 不 同 ， 状 态 分 支 策 略 引 入 了 分 支 位 置 或 快照 的 概念 。 我 们 使 用 的 部 署 
图 通常 过 于 简化 ， 告 诉 我 们 代码 从 一 个 环境 迁移 到 另 一 个 环境 〈 见 图 3-5), 但 事情 并 没 
有 这 么 简单 。 图 3-6 显示 代码 从 一 个 分 支 合并 到 另 一 个 分 支 ， 且 甚 中 每 个 分 支 都 被 部 署 到 
一 个 特定 的 环境 中 。( 我 们 会 在 以 后 讨论 带 标签 的 发 布 ， 别 心急 。) 如 图 3-6 所 示 ， 我 们 
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使 用 的 分 支 名 称 和 部 署 环境 的 名 称 通常 不 同 。(master 是 什么 意思 ? 这 是 用 于 产品 发 布 的 


分 支 吗 ? 还 是 开发 的 分 支 ? 你 确定 吗 ? ) 这 个 策略 称 为 GitLab 流程 (https://about.gitlab. 
com/2014/09/29/eitlab-flow/) 模型 。 





本 地 环境 开发 环境 发 布 前 的 准备 生产 环境 
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图 3-5. 部 署 的 谎言 : 代码 其 实 并 没有 从 本 地 服务 器 移动 到 产品 服务 器 
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图 3-6: 真实 的 部 署 过 程 使 用 了 集中 式 的 代码 托管 系统 


通过 分 支 的 命名 约定 ，GitLab 流程 使 我 们 明白 什么 代码 用 于 什么 环境 ， 以 及 在 合并 提交 前 
需要 满足 哪些 条 件 。 比 如 ， 你 一 定 不 希望 将 未 经 测试 的 代码 并 入 一 个 叫 作 production 的 分 
支 。 或 者 ， 如 果 你 要 将 代码 交付 给 “外 界 ”，GitLab 流程 会 建议 你 使 用 预 发 分 支 。 理 想 情 
况 下 ， 这 些 预 发 分 支 应 该 遵守 语义 化 版 本 命名 (http//semver.org/) 约定 ， 尽 管 GitLab 没 
有 明确 要 求 这 一 点 。 








在 语义 化 版 本 命名 中 ， 如 何 增 加 版 本 号 

在 语义 化 版 本 命名 中 ， 发 布 的 版 本 号 总 是 应 该 遵循 这 样 的 格式 : MAJOR. 
MINOR.PATCH。 第 一 个 数字 (MAJOR， 主 版 本 ) 应 该 在 进行 了 无 法 向 后 兼 
容 的 API 修改 时 增加 。 第 二 个 数字 (MINOR， 次 版 本 ) 应 该 在 增加 新 功能 但 
是 不 会 打破 已 有 的 功能 (也 就 是 向 后 兼容 ) 时 增加 。 第 三 个 数字 (PATCH, 
修订 版 本 ) 应 该 在 进行 了 向 后 兼容 的 bug 修复 时 增加 。 
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Git 项 目 使 用 的 分 支 命 名 约定 (https://www.kernel.org/pub/software/sem/git/docs/gitworkflows. 
html) 是 状态 分 支 策略 的 一 个 很 有 意思 的 变种 。 它 拥有 以 下 四 种 专门 命名 的 集成 分 支 。 
* maint 

这 个 分 支 包含 了 Git 最 近 一 次 稳定 发 布 的 代码 以 及 小 数 点 版 本 的 额外 提交 (维护 )。 
* master 

这 个 分 支 包含 应 该 进入 下 一 次 发 布 的 提交 。 
* next 

这 个 分 支 用 于 测试 一 些 主题 在 进入 master 分 支 后 的 稳定 性 。 
. pu 

这 个 建议 的 更 新 (proposed updates) 分 支 包 含 尚未 准备 好 合并 的 提交 。 
分 支 之 间 的 关系 就 如 同一 个 堆 登 的 金字 塔 一 样 。 每 一 个 “底层 ”的 分 支 包 含 “ 上 层 ” 分 支 
中 没有 的 提交 。 如 图 3-7 所 示 ，maint 拥有 最 少 的 提交 ， 而 pu 拥有 最 多 的 提交 。 一 旦 代码 
进入 审查 流程 ， 它 将 被 并 入 下 一 个 集成 分 支 ， 离 进入 官方 发 布 又 进 了 一 步 。 
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3-7: Git 项 目 使 用 的 集成 分 支 

使 用 状态 分 支 策略 具有 以 下 两 个 优点 。 

。 分 支 名 称 与 手头 工作 的 上 下 文 密切 相关 。 

。 无 需 猜测 就 能 明白 每 个 分 支 的 目的 ， 在 合并 自己 的 工作 时 更 容易 选择 正确 的 分 支 。 
同时 ， 使 用 状态 分 支 策略 也 有 以 下 两 个 缺点 。 

。 在 没有 指导 的 情况 下 ， 并 非 总 是 能 很 容易 找到 从 哪 开始 新 建 一 个 分 支 。 


。 由 于 分 支 名 与 团队 的 上 下 文 密切 相关 ， 在 项 目 中 保持 一 致 可 能 会 更 困难 ， 使 得 新 人 上 和 手 
时 更 加 困惑 。 
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在 我 自己 的 项 目 中 ， 我 通常 选择 这 个 风格 的 分 支 策略 。 我 喜欢 使 用 我 容易 理解 的 词汇 ， 而 
不 是 其 他 团队 中 的 其 他 人 熟悉 的 词语 。 如 果 你 对 细节 十 分 在 意 ， 那 么 请 保持 一 致 ! 除非 你 
倾向 于 使 用 自己 的 词汇 。 


3.3.4 计划 部 署 

如 果 你 没有 一 个 完全 自动 化 的 测试 集 ， 却 必须 计划 一 个 部 署 ， 那 么 计划 部 署 分 支 是 最 适合 
你 的 策略 。 或 许 是 因为 你 需要 遵循 部 署 窗 口 期 (比如 ， 从 不 在 下 午 4 点 后 部 署 ， 也 从 不 在 
周 五 部 署 ) ， 或 许 是 因为 要 通过 额外 的 机 构 审查 〈( 比 如， 在 将 iOS 应 用 部 署 到 App Store 之 
前 )。 只 要 有 人 介入 审查 流程 ， 或 其 他 人 对 你 的 部 署 过 程 施加 了 任何 限制 ， 你 的 部 署 就 不 
可 避免 地 会 出 现 延期 ， 在 等 待 时 你 需要 想 办 法 中 断 你 的 工作 。 


通过 使 用 不 同类 型 的 分 支 策 略 ， 我 们 不 断 增 加 仓库 内 分 支 的 复杂 度 。 最 开始 我 们 只 有 一 个 
分 支 ， 然 后 加 上 了 功能 和 集成 分 支 。 在 计划 部 署 中 ， 我 们 也 要 这 么 做 。 但 是 ， 计 划 部 署 的 
分 支 模 式 可 能 会 渐渐 变 得 非常 复杂 。 复 杂 度 应 该 逐渐 上 升 ， 而 且 仅 在 必要 时 增加 。 

在 本 市 中 ， 我 将 会 带 你 了 解 如 何在 团队 中 实施 GitFlow 分 支 策略 ， 并 了 解 其 演化 历程 。 
GitFlow 是 计划 部 署 策略 最 流行 的 实现 ， 最 初 由 Vincent Driessen (http://nvie.com/posts/ 
a-successful-git-branching-model/) 提出 。 它 被 世界 上 无 数 的 团队 用 于 构建 软件 项 目 ， 其 最 
终 形式 可 能 看 上 去 非常 复杂 。 但 幸运 的 是 ， 软 件 项 目的 构建 是 循序 渐进 的 ， 不 是 一 跃 而 就 
的 。 如 果 GitFlow 中 某 些 部 分 与 你 的 团队 无 关 ， 你 可 以 在 你 的 项 目 中 忽略 它们 。 

我 们 一 起 来 仔细 了 解 这 个 模型 。 

最 初 你 的 软件 项 目 只 有 一 个 分 支 ，develop。 在 这 个 分 支 上 ， 程 序 员 创建 与 之 偏离 的 分 支 
并 在 上 面 添 加 他 们 的 功能 。 图 3-8 显示 ， 此 时 GitFlow 的 状态 图 与 本 章 先 前 介绍 的 模型 十 
分 相似 。 在 这 里 ， 我 会 使 用 广义 的 “功能 ”术语 。 在 理想 的 团队 协作 中 ， 功 能 将 在 你 开 
始 工作 前 在 工 单 中 进行 描述 ， 且 分 支 名 将 会 包含 这 个 工 单 名 。 比 如 ， 如 果 你 有 一 个 工 单 
“1234”， 代 表 一 个 修复 失效 链接 的 bug 报告 。 若 使 用 [ticket id]-[terse title] 的 命名 约 
定 ， 那 么 你 的 分 支 名 应 该 是 1234-fixing_links。 
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短暂 存在 的 分 支 ， 通 常 与 工 单 对 应 

















3-8: GitFlow 中 使 用 的 开发 和 功能 分 支 


你 的 团队 不 断 地 工作 、 工 作 再 工作 ， 直 到 某 一 刻 宣布 “没有 新 的 功能 要 做 了 ”。 我 们 通常 
将 这 个 时 间 节 点 叫 作 功 能 冻结 (feature freeze)。 此 时 ， 会 从 开发 分 支 上 创建 一 个 新 的 分 
支 ， 如 图 3-9 所 示 ， 只 有 bug 修复 能 够 提交 到 这 个 分 支 上 。 这 些 bug 可 能 包括 性 能 衰退 、 
安全 漏洞 和 一 些 其 他 问题 。 在 更 传统 的 课 布 流 团 队 结构 中 ，bug 修复 的 阶段 应 该 由 质量 保 
证 团队 带领 。 在 更 敏捷 的 团队 中 ， 开 发 者 从 一 系列 分 支 到 部 署 都 一 直 跟 进 这 些 问题 ， 甚 至 
可 能 会 负责 测试 其 他 人 的 工作 。 我 们 将 会 在 第 8 章 中 更 详细 地 讨论 评审 过 程 。 

功能 冻结 时 或 许 不 是 所 有 功能 都 完成 了 ， 所 以 仍然 有 工作 被 提交 至 develop 分 支 。 如 果 发 
现 了 bug， 这 些 bug 同样 需要 被 “向 后 ”并 入 develop 分支 。 图 3-10 显示 了 在 代码 并 入 两 
个 不 同方 向 时 ， 我 们 看 到 的 分 支 图 。 你 的 质量 保证 阶段 越 长 ，develop 分 支 和 预 发 分 支 上 
越 有 可 能 出 现 同 时 进行 的 工作 。 































































































1.0 版 本 的 ”二 中 ， 1234-fixing  1235-horse 1236-cart 
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3-9: GitFlow 中 的 功能 冻结 ， 只 允许 bug 修复 
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图 310: 开发 继续 ， 但 不 会 并 入 预 发 分 支 
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经 过 一 段 时 间 的 测试 ， 所 有 bug Zt AEPL. R PRR. AER] 
此 时 ， 所 有 经 过 了 质量 保证 测试 的 代码 都 被 提交 到 一 个 新 的 分 支 ，master 上 ， 这 些 代 码 被 
打上 了 软件 当前 版 本 号 的 标签 (就 像 书签 一 样 )。 接 着 这 个 软件 会 如 图 3-11 所 示 的 那样 进 
行 部 署 。 你 的 项 目 经 理 给 你 一 个 心 形 糖果 ， 或 者 一 个 GIF 动画 ， 然 后 你 就 可 以 下 班 了 。 F 
得 漂亮 ， 队 员 们 ! (如果 你 的 项 目 经 理 没 有 这 么 做 ,请 把 我 的 建议 发 给 他 们 ， 我 会 帮 你 和 
他 们 谈 谈 。 我 们 都 是 朋友 ， 没 什么 大 不 了 的 。) 
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图 3-11; 代码 并 入 一 个 新 的 分 支 master 并 打上 标签 ， 从 而 软件 得 以 发 布 

当然 ， 在 现实 中 ， 有 些 需要 立即 进行 修复 的 bug 将 会 潜入 软件 中 。 这 些 补丁 (hotfix) 十 分 
关键 ， 程 序 员 应 该 在 晚上 回 家 前 就 修复 这 些 bug。 它 们 通常 是 从 产品 分 支 拉 出 的 一 条 新 的 分 
支 ， 当 补丁 发 布 后 ， 它 们 不 包含 任何 上 次 官方 发 布 后 进行 的 额外 工作 ， 如 图 3-12 所 示 。 











在 你 的 团队 中 定义 “紧急 ” 
有 一 次 ， 一 个 与 我 合作 过 的 开发 者 告诉 我 ， 如 果 一 个 bug 必须 要 在 他 去 酒吧 
喝 杯 啤 酒 之 前 进行 修复 ， 那 么 必须 将 这 个 bug 标记 为 补丁 。 他 的 话 从 根本 上 
改变 了 我 如 何 理解 那些 标记 为 紧急 的 问题 。 我 们 重新 校准 了 “紧急 ”的 定 
义 ， 最 终 减少 了 熬夜 的 次 数 。 同 样 地 ， 我 曾经 接触 过 的 一 个 客户 喜欢 把 工 单 
标记 为 “非常 重要 ， 但 不 急 着 做 ”。 你 可 以 拿 你 的 命名 约定 开玩笑 ， 但 确保 
记 下 了 它们 的 含义 ， 避 免 由 于 困扰 造成 的 匆忙 赶 工 。 
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图 3-12; 一 个 补丁 完成 后 进入 master 分 支 ， 现 在 我 们 的 发 布 标签 是 1.0.1 


由 于 需要 在 不 同 场 所 中 继续 不 同 的 工作 ， 我 们 渐渐 构建 了 这 些 分 支 。 你 不 需要 一 开始 就 建 
并 所 有 分 支 。 事 实 上 ， 最 好 不 要 这 么 做 ， 因 为 到 最 后 你 会 发 现 需要 维护 的 代码 更 多 了 。 一 


旦 你 同时 拥有 了 产品 代码 和 开发 代码 ， 那 么 最 终 会 在 分 支 状 态 
点 ， 正 如 图 3-12 所 示 。 对 于 新 人 来 说 这 会 是 非常 麻烦 的 ， 但 对 于 人 














图 中 拥有 一 大 堆 活 路 的 节 
随 项 目 一 路 走 来 的 开发 


者 来 说 ， 这 是 一 个 自然 的 过 程 。 如 果 你 选择 使 用 这 个 约定 ， 先 前 有 过 相似 经 验 的 新 来 的 开 


发 者 也 会 感到 非常 熟悉 。 
使 用 计划 部 署 策略 具有 以 下 四 个 优点 。 
。 计划 部 署 不 要 求 你 预先 准备 好 全 夯 














i 的 测试 设施 。 


。 软件 的 构建 过 程 通常 伴随 着 开发 、 质 量 保证 、 生 产 这 些 阶段 。 也 就 是 说 ， 一 旦 软件 开发 
者 理解 了 分 支 约定 中 如 何以 及 何 时 进行 他 们 的 日 常任 务 ， 他 们 便 会 对 GitFlow 约定 感到 











非常 熟悉 。 








。 通过 严格 遵守 约定 ， 开 发 者 总 能 明确 自己 应 该 从 哪个 分 支 开始 工作 。 
。 这 个 模型 同样 适用 于 版 本 化 管理 的 软件 ， 如 应 用 商店 中 下 载 的 应 用 ， 这 些 应 用 不 适合 每 





隔 几 天 部 署 一 个 新 版 本 。 
使 用 计划 部 署 分 支 策略 也 有 以 下 三 个 缺点 。 





。 对 于 刚 接触 到 软件 部 署 并 且 没 有 经 历 过 整个 开发 流程 的 开发 者 ， 存 在 较 多 的 认 知 负担 。 
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。 如 果 开 发 者 从 错误 的 分 支 开 始 工作 ， 要 将 所 有 工作 恢复 同步 是 件 困难 的 事情 。 

。 它 不 如 持续 集成 那么 流行 。 

计划 部 署 策略 提供 了 最 严格 的 约定 ， 规 范 了 代码 应 该 如 何在 通过 评审 后 移动 。 它 通常 在 几 
乎 没有 自动 化 的 代码 评审 中 被 使 用 ， 并 且 总 是 出 现在 没有 应 用 自动 化 部 署 计 划 的 某 些 项 目 
中 。 工 作 收 集 到 项 目 且 尚未 发 布 时 ， 你 将 会 至 少见 到 本 市 中 描述 的 一 些 特征 。 


34 ”更 新 分 支 


本 章 主要 介绍 用 于 隔离 和 合并 几 股 工作 的 常见 策略 。 这 些 策略 集中 于 一 个 单一 最 佳 路 径 的 
场景 中 ， 其 中 不 同 分 支 的 工作 神奇 地 与 其 他 相关 的 工作 保持 同步 。 在 分 布 式 版 本 控制 系统 
中 ， 整 合 外 部 工作 的 方法 与 你 选择 的 分 支 策 略 无 关 。 更 新 分 支 时 ， 你 可 以 选择 其 中 一 种 策 
W: 合并 (merge) 或 变 基 (rebase)。 在 深入 了 解 这 两 种 策略 的 差异 前 ， 我 们 先 来 简单 地 
了 解 一 下 多 个 仓库 之 间 的 连接 是 如 何 维持 的 。 


每 个 Git 仓库 都 是 一 份 自治 的 更 改 记录 。 仓 库 之 间 的 连接 通过 一 个 远程 的 引用 建立 。 这 个 
应 用 允许 开发 者 将 远程 仓库 中 所 有 提交 对 象 复制 到 自己 的 本 地 仓库 。 远 程 连接 通常 用 于 至 
少 共 用 部 分 历史 的 仓库 。 比 如 ， 第 一 次 使 用 命令 clone 下 载 仓库 ， 将 会 出 现 一 份 远程 仓库 
及 其 提交 对 象 的 副本 。 


例如 ， 你 想 要 将 你 的 工作 添加 到 同事 的 分 支 上 。 你 连接 到 他 们 的 远程 仓库 ， 拉 取 分 支 并 党 
试 添加 你 的 工作 。 但 你 不 能 这 么 做 ! 如 果 那 是 一 个 本 地 分 支 ， 你 可 以 在 分 支 顶端 添加 一 些 
新 的 提交 对 象 。 但 是 ， 因 为 你 希望 更 新 的 是 一 个 远程 分 支 ， 所 以 你 无 法 将 一 个 新 的 提交 对 
象 放置 到 你 的 仓库 中 那个 分 支 的 顶端 ， 因 为 这 个 操作 只 能 由 远程 仓库 的 所 有 者 完成 。 与 此 
相反 ， 你 必须 先 创 建 一 个 新 的 跟踪 分 支 来 储存 你 的 更 改 。 










































































一 些 跟踪 分 支 是 自动 的 
clone 命令 将 会 默认 创建 一 个 名 为 master 的 跟踪 分 支 ， 和 与 它 同 名 的 远程 分 
支 保 持 一 致 。 





现在 你 有 了 一 个 可 以 添加 新 提交 的 分 支 的 本 地 副本 ， 一 个 不 能 添加 提交 的 分 支 的 引用 副 
本 ， 以 及 一 个 仍然 存在 于 远程 仓库 的 原 分 支 。 当 你 和 你 的 同事 分 别 在 自己 的 仓库 中 进行 更 
改 时 ， 这 些 分 支 将 会 不 可 避免 地 不 再 保持 同步 。fetch 命令 将 会 更 新 分 支 的 引用 副本 ， 下 
载 所 有 新 的 提交 。 这 个 分 支 的 可 变 跟踪 副本 ， 有 多 种 更 新 方式 。 这 是 因为 你 现在 将 两 个 分 
支 并 入 一 个 ， 这 个 操作 在 Git 中 对 应 了 多 种 策略 。 有 选择 就 会 有 分 歧 ， 会 争论 应 该 使 用 哪 
种 方法 。 

通过 远程 引用 更 新 跟踪 分 支 的 过 程 通常 借助 pull 命令 实现 。 然 而 ，pull 是 两 个 无 关 步 又 
的 组 合 : fetch 和 merge， 或 者 fetch 和 rebase。pull 命令 默认 使 用 merge 策略 来 更 新 本 地 
分 支 ， 但 是 ， 通 过 添加 - -rebase 参数 ， 开 发 者 可 以 选择 通过 rebase 策略 来 更 新 自己 的 本 
地 分 支 。 
































两 种 变 基 的 方式 

变 基 在 更 新 一 系列 提交 时 有 两 种 方式 。 第 一 种 ， 在 相关 分 支 上 整合 新 的 工作 
(更 新 一 个 分 支 ) 时 用 于 代替 合并 。 第 二 种 ， 通 过 增删 修改 分 支 上 的 提交 历 
史 中 的 特定 提交 来 更 改 现 有 分 支 上 的 历史 ， 达 到 使 历史 更 加 精简 的 目的 。 本 
节 指 的 是 前 一 种 方式 。 














变 基 给 人 带 来 的 印象 是 复杂 和 繁琐 的 。 但 从 图 形 化 的 角度 来 说 ， 变 基 是 可 读 性 最 佳 的 策 
W&, Fd 3-13 显示 了 从 一 个 分 支 变 基 至 另 一 个 分 支 前 后 的 变化 。 一 般 来 说 ， 我 们 将 变 基 解 释 
为 在 一 个 已 有 的 时 间 线 上 重 放 已 有 的 提交 。 这 个 比喻 虽然 在 技术 上 有 些 出 入 ， 但 很 好 地 解 
释 了 合并 和 变 基 之 间 的 差异 。 

















主 分 支 工作 分 支 主 分 支 工作 分 支 




















图 3-13: 变 基 两 个 分 支 时 只 改变 其 中 一 个 分 支 的 历史 ， 而 另 一 个 分 支 看 上 去 没有 变化 


rebase 命令 用 于 更 新 分 支 ， 而 merge 命令 用 于 引入 全 新 的 工作 。 当 merge 命令 用 于 快 进 
(fast-forward) 策略 时 ， 状 态 图 和 变 基 后 的 图 形 并 无 二 致 。 快 进 策略 只 有 在 合并 只 包含 并 
入 分 支 中 已 有 的 提交 时 才能 够 使 用 。 图 3-14 显示 ， 快 进 合并 的 图 形 和 变 基 一 样 整洁 。 

当 两 个 分 支 上 都 有 新 的 工作 时 ， 如 果 你 希望 合并 这 些 工 作 ， 那 么 将 会 需要 在 一 个 新 的 提交 
中 储存 合并 后 的 工作 。 你 可 以 使 用 不 同 的 合并 策略 ，Git 会 选择 对 你 最 合适 的 一 种 策略 。 
如 果 你 对 不 同 的 合并 策略 非常 感 兴趣 ，Git 介绍 合并 的 帮助 页 面 会 告诉 你 章鱼 式 合并 (两 
分 支 以 上 的 合并 ) 和 递归 式 合并 有 哪些 差别 。 要 阅读 文档 ， 请 运行 gqit help merge 命令 。 
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不 知道 如 何 选 择 合并 和 变 基 ? 

使 用 快 进 合并 或 变 基 的 两 个 分 支 所 产生 的 状态 图 几乎 是 一 样 的 。 因 此 ， 选 择 
哪 种 策略 有 些 令 人 困惑 。 事 实 上 ， 这 种 选择 是 如 此 困惑 以 至 于 一 些 团队 选 
择 混合 使 用 这 两 个 命令 。 如 果 你 花费 一 些 时 间 来 理解 在 什么 时 候 使 用 哪 种 
策略 ， 就 将 能 够 敏捷 地 在 不 同 项 目 中 选择 不 同 的 策略 使 用 。 合 并 还 是 变 基 
(http://gitforteams.com/resources/merge-rebase.html) 提供 了 一 个 决策 树 来 帮助 
你 认 清 应 该 使 用 其 中 哪 种 策略 。 
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图 3-14: 使 用 快 进 策略 合并 两 个 分 支 和 使 用 变 基 一 样 整洁 


如 果 你 希望 通过 合并 来 让 手头 的 工作 保持 同步 ， 图 形 化 的 历史 将 会 变 得 难以 阅读 ， 因 为 其 
中 的 连接 变 成 了 双向 的 。 也 就 是 说 ， 历 史 在 两 个 分 支 间 突然 转向 ， 因 为 代码 已 经 同步 ， 而 
新 的 功能 也 发 布 到 了 主 分 支 上 。 图 3-15 显示 了 合并 是 如 何 记 录 提 交 的 来 源 的 。 如 果 你 正在 
将 一 个 功能 分 支 并 入 项 目的 主 开 发 分 支 ， 那 么 这 会 是 你 希望 看 到 的 。 但 如 果 你 只 希望 阅读 
当前 功能 的 历史 ， 则 会 感到 有 些 困惑 ， 因 为 主 开发 分 支 将 会 进入 你 的 历史 图 ， 而 功能 分 支 
和 集成 分 支 合 并 后 的 连接 都 会 被 画 在 上 面 。 

由 于 一 些 同步 的 问题 ， 使 用 Git 的 开发 者 如 果 准 备 将 他 们 的 工作 提交 回 项 目 ， 那 么 他 们 通 
常 不 会 在 跟踪 分 支 上 工作 。 取 而 代 之 ， 开 发 者 将 会 创建 这 个 分 支 的 第 四 份 副本 (一 份 是 跟 
踪 分 支 的 副本 ， 跟 踪 分 支 是 引用 分 支 的 副本 ， 而 引用 分 支 是 远程 分 支 的 副本 )。 不 管 使 用 
哪 种 分 支 策略 ， 跟 踪 分 支 可 以 映射 到 任何 长 期 运行 的 分 支 (比如 主 分 支 或 预 发 分 支 )， 且 
工作 分 支 是 一 个 功能 、 工 单 或 补丁 分 支 。 

通过 分 支 变 基 来 保持 同步 使 得 图 像 简 化 ， 而 历史 变 得 更 易于 阅读 。 然 而 ， 变 基 也 要 付出 一 
些 代价 ， 尤 其 是 当 你 的 分 支 副 本 中 包含 刚 创建 的 提交 对 象 时 。 为 了 变 基 一 个 包含 独特 提交 
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的 分 支 ， 你 必须 将 每 个 提交 一 个 个 重 放 至 新 分 支 的 顶端 ，Git 为 每 个 提交 分 配 了 一 个 新 的 
标识 符 ， 因 为 每 个 提交 都 分 配 到 了 一 个 新 的 父 节点 。 如 果 在 分 配 到 一 个 新 的 父 节点 提交 之 
前 共享 至 其 他 远程 仓库 ， 那 么 这 可 能 会 造成 困惑 。 除 了 新 的 标识 符 以 外 ， 每 当 你 重 放 一 个 
提交 时 ， 都 有 可 能 出 现 合并 冲突 ， 有 时 解决 冲突 非常 耗 时 。 这 有 点 像 维护 考勤 表 ， 只 要 你 
每 天 投入 一 点 时 间 保 持 你 的 考勤 表 同步 ， 就 不 会 出 现 什么 大 问题 。 但 如 果 你 实在 记 不 住 每 
天 在 考勤 表 上 做 记录 ， 那 么 回顾 并 补 全 之 前 的 记录 会 是 非常 耗 时 的 。 通 过 变 基 策略 维护 一 
个 同步 的 分 支 带 来 的 奖励 是 一 个 易于 阅读 的 分 支 历史 。 但 它 真 的 值得 吗 ?如 果 Git 新 手 还 
不 怎么 习惯 解决 合并 冲突 ， 那 么 他 们 会 感到 非常 受挫 。 
留 给 你 一 个 课 后 作业 ， 和 你 的 团队 讨论 以 下 哪 一 点 更 重要 易 用 性 (选择 合并 来 保持 分 支 
同步 )， 还 是 易 读 的 历史 记录 (选择 编辑 来 保持 分 支 同步 )。 






































tox ”工作 分 支 Tex ”工作 分 支 cox IFE 









































合并 前 使 用 合并 更 新 分 支 将 工作 分 支 并 入 共享 的 主 分 





图 3-15: 不 使 用 快 进 策略 合并 两 个 分 支 


3.5 iM 


如 果 你 使 用 Git 托管 系统 ， 如 GitHub, Bitbucket 或 GitLab， 分 支 可 能 被 用 于 分 隔 一 个 特 
定 bug 或 功能 工 单 对 应 的 工作 。 根 据 你 使 用 的 分 支 策略 ， 你 的 目标 或 许 是 让 分 支 无 限期 地 
分 隔 ， 或 者 你 或 许 希 望 经 常 将 这 些 分 别 完成 的 工作 合并 到 一 个 可 部 署 的 分 支 中 。 尽 管 所 有 
信息 都 储存 在 仓库 中 ， 但 在 某 一 时 刻 只 有 一 个 分 支 可 见 。 所 以 ， 如 果 你 有 两 个 想法 正在 同 
时 进行 ， 并 且 和 希望 它们 同时 在 服务 器 上 出 现 ， 你 将 会 需要 将 这 两 个 分 支 并 入 一 个 常用 的 分 
X, 来 让 它们 同时 可 见 。 



































本 章 介绍 了 使 用 Git 时 的 几 种 分 支 策 略 ， 以 及 某 些 团队 使 用 过 的 这 些 策 略 的 一 些 变种 ， 如 
下 所 列 。 


。 主线 开发 

。 功能 分 支部 署 

。 状态 分 支 

。 计划 部 署 

除了 这 些 策略 以 外 ， 你 还 将 决定 你 的 团队 需要 如 何 将 各 自 的 新 工作 并 入 共享 的 分 支 ， 并 保 
持 分 支 最 新 。 对 于 新 手 团 队 ， 如 何 保持 分 支 最 新 并 不 总 是 显而易见 的 。 有 两 种 策略 可 供 选 
择 : 变 基 或 合并 。 变 基 策 略 如果 不 定期 执行 ， 就 会 变 得 尤为 麻烦 ， 但 它 确 实 能 使 你 的 历史 
记录 的 图 像 更 加 整洁 ， 从 而 易于 浏览 。 通 过 使 用 合并 来 保持 分 支 最 新 ， 浏 览 项 目 历史 将 会 
变 得 更 困难 。 因 此 ， 如 果 你 的 工作 起 源 不 重要 ， 可 以 选择 其 中 任 一 策略 ， 但 如 果 你 要 经 常 
浏览 历史 记录 ， 变 基 会 使 未 来 的 工作 更 容易 (即使 现在 来 看 更 耗 时 了 )。 
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工作 流 





我 喜欢 和 团队 一 起 讨论 并 制定 行动 计划 ， 便 利 贴 和 白板 越 多 越 好 。 在 这 个 过 程 中 ， 可 能 会 
有 一 些 和 争吵 和 妥协 ， 但 最 终 大 家 能 在 最 基本 的 流程 上 达成 一 致 。 每 个 人 回 到 自己 的 桌 前 ， 
思考 自己 要 做 的 方向 ， 并 迅速 发 同 “ 我 应 该 怎么 开始 呢 ”。 你 给 团队 更 多 的 提示 来 开始 工 
作 ， 他 们 就 能 将 更 多 的 精力 花 在 攻克 难题 上 。 版 本 控制 永远 不 应 该 是 一 个 难题 。 

完成 本 章 学 习 之 后 ， 你 将 能 够 创建 涵盖 以 下 内 容 的 分 步 文 档 。 

。 基本 工作 流 

。 集成 分 支 

。 发 布 计 划 

。 发 布 后 的 补丁 

本 章 安排 了 一 些 精 选 的 案例 学 习 ， 介 绍 我 在 之 前 的 团队 中 是 如 何 高 效 地 使 用 Git 的 。 你 将 
会 注意 到 我 对 敏捷 方法 的 强烈 偏爱 ， 尤 其 是 本 章 中 的 Scrum。 这 个 协作 流程 与 流行 的 工作 
流 模 型 GitFlow (http://nvie.com/posts/a-successful-git-branching-model/) 配合 良好 。 如 果 你 
已 经 对 GitFlow 非常 熟悉 ， 仍 然 应 该 阅读 本 章 的 第 一 节 ， 了 解 如 何 建立 并 记录 团队 的 工作 
过 程 。 


4.1 初 识 工作 流 

在 第 2 章 中 ， 你 学 到 了 治理 模型 。 在 第 3 章 中 ， 你 学 到 了 分 支 策 略 。 使 用 Git 的 工作 方式 
可 能 会 很 快 变 得 非常 复杂 ， 而 且 复 杂 度 越 高 ， 要 记 住 所 有 事情 就 越 困 难 。 在 你 的 团队 中 要 
建立 约定 来 维护 一 致 性 ， 以 帮助 你 快速 理解 你 的 代码 历史 。 

在 本 节 中 ， 你 将 学 到 以 下 内 容 。 

。 记录 团队 进展 的 基本 工具 
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。 文档 应 该 放 在 什么 地 方 
。 什么 类 型 的 事情 需要 记录 
。 工 单 系统 中 的 样 合 状态 


与 你 的 团队 聊 聊 他 们 想 要 怎样 协作 这 个 问题 ， 这 永远 都 不 壕 ， 改 善 你 现 有 的 流程 也 永远 都 
不 晚 。 如 果 你 使 用 敏捷 方法 ， 那 么 应 该 已 经 安排 了 专门 用 于 回顾 会 议 的 时 间 ， 或 是 使 用 持 
续 改善 (Kaizen) 方法 来 评审 开发 过 程 。 


4.1.1. 记录 工作 过 程 


Git 作为 一 个 无 感知 的 软件 ， 并 不 关心 你 是 如 何 组 织 事物 的 。 放 轻松 如果 你 用 错 了 分 支 
名 ,或 者 把 合并 当成 变 基 使 用 ，Git 不 会 突然 从 你 的 电脑 里 跳出 来 ， 用 手指 着 你 ， 告 诉 你 
做 错 了 (尽管 我 有 时 觉得 Git 如 果 这 样 做 也 挺 好 的 )。 你 使 用 Git 的 方式 完全 取决 于 你 自 
E 


最 简单 的 保持 一 致 的 方法 是 遵循 一 组 规则 ， 或 是 一 份 清单 。 每 次 在 一 个 新 的 地 方 工 作 时 ， 
应 该 记录 下 你 的 工作 流 。 通 过 从 模板 开始 ( 例 4-1) 工作 ， 能 够 确保 现在 看 上 去 “ 显 而 易 
见 ” 的 细节 ， 在 新 人 到 来 甚至 混乱 到 来 时 仍然 是 显而易见 的 。 


例 4-1 模板 工作 流 
项 目 经 理 : 名 字 
开发 站 点 :URL 
开发 站 点 上 部 署 的 分 支 :分 支 名 
线 上 站 点 :53URL 
线 上 站 点 上 部 署 的 分 支 :分 支 名 
开始 一 个 新 的 开发 工 单 时 ,从 哪个 分 支 创 建新 的 分 支 :分 支 名 
开始 一 个 新 的 补丁 工 单 时 ,从 哪个 分 支 创建 新 的 分 支 :分 支 名 
更 新 工作 时 ,使 用 ;Git 命令 
评审 后 合并 时 ,使 用 ;Git 命令 


文档 中 包含 的 细节 越 多 ， 队 友之 间 的 一 致 性 就 越 强 ， 回 顾 仓库 中 的 历史 记录 也 就 越 方便 。 
如 果 你 的 团队 都 在 一 起 ， 那 就 坐 下 来 勾勒 一 张 图 ， 描 述 代 码 中 应 该 怎么 区 分 权限 。 如 果 你 
在 分 布 式 团队 中 ， 也 并 不 意味 着 就 不 能 勾勒 这 张 图 了 。 而 且 你 不 需要 变 成 一 个 插画 家 。 有 
很 多 漂亮 的 图 表 软 件 能 够 帮 你 勾勒 你 的 想法 。 我 是 Balsamiq (https://balsamiq.com/) 的 狂热 
粉丝 ， 常 用 它 来 画 很 简单 的 图 。 还 有 人 推荐 了 Pencil (http://pencil.evolus.vn/)、OmniGraffle 
(https:Wwww.omnigroup.com/omnigraffle) 、Dia (http://dia-installer.de/) 和 Inkscape (http://www. 
inkscape.org/en/)。 第 2 章 中 的 图 对 于 很 多 团队 来 说 也 是 一 个 很 好 的 出 发 点 。 这 本 书 中 所 有 的 
图 都 同时 提供 SVG 和 Balsamiq 两 种 格式 的 文件 。 你 可 以 前 往 “Git 团队 协作 ”图 表 (https/ 
github.com/gitforteams/diagrams) 仓库 下 载 。 


4.1.2 ”记录 编码 的 决定 
我 在 整 本 书 中 都 会 提 到 工 单 或 issue! 的 处 理 。 开 源 软 件 项 目的 严谨 性 众生 了 非常 多 优秀 的 工 


































































































































































































注 1: isu 本 义 表 示 一 个 问题 。 在 Git 托管 系统 中 ，Issues 是 一 个 专门 的 板块 ， 列 出 所 有 bug 报告 、 功 能 请 求 
和 项 目 相关 讨论 。 每 一 个 issue 为 一 条 工 单 ， 而 Issues 就 是 一 个 工 单 系统 。 译 者 注 
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作 习惯 ， 其 中 一 个 是 使 用 bug 跟踪 工具 来 捕捉 所 有 需求 。 对 于 开源 项 目 而 言 ， 我 在 不 同 产 
品 中 使 用 了 不 同 的 跟踪 工具 ， 比 如 Drupal 项 目 模块 (https://drupal.org/project/project， 它 被 亲 
切 地 称 为 issue 队列 ) 和 一 些 通用 的 方案 ， 如 GitHub (https://github.com/)。 对 于 内 部 项 目 来 
说 ， 我 还 用 过 Pivotal Tracker (http//www.pivotaltracker.com/), JIRA (https://www.atlassian.com/ 
software/jira), Redmine (http://www.redmine.org/) 和 Unfuddle (https://unfuddle.com/)。 


每 个 系统 各 有 优 缺 点 。 我 没有 一 个 最 喜欢 的 产品 。 从 本 质 上 来 讲 ， 这 些 系统 人 允许 你 记录 、 
跟踪 即将 完成 的 工作 、 需 要 完成 的 任务 ， 以 及 与 任何 在 质量 保证 测试 中 发 现 的 后 续 问 题 
相关 的 讨论 。 我 无 法 想象 如 何 与 一 个 没有 集中 式 工 单 跟踪 工具 来 记录 已 完成 工作 的 团队 
合作 。 

在 一 起 工作 的 团队 可 以 使 用 白板 和 便利 贴 来 展示 当前 正在 进行 的 工作 。 一 些 团 队 也 用 非常 
简单 的 表格 来 跟踪 谁 正在 做 哪个 任务 。 或 许 对 话 和 相关 的 资源 (如 图 表 、 设 计 资 源 和 线 
框图 ) 可 以 存放 在 Wiki 中 ， 这 样 白 板 可 以 擦 干净 供 下 次 对 话 使 用 。 不 论 你 使 用 什么 系统 ， 
我 鼓励 你 在 易于 阅读 且 方 便 搜索 的 系统 中 ， 至 少 记 下 决定 做 这 些 功 能 的 原因 。 如 果 你 没有 
把 这 些 信息 写 下 来 ， 那 么 以 后 可 能 会 苦 苦 猜 测 当 初 为 什么 作出 了 这 些 决 定 。 

然而 ， 如 果 在 每 次 更 改 仓 库 时 的 提交 说 明 中 没有 同时 包含 决定 ， 那 么 团队 会 对 使 用 的 某 个 
工 单 系统 产生 依赖 。 你 的 团队 可 能 会 认为 对 话 是 临时 的 ， 于 是 将 结论 记 在 了 提交 说 明 中 ， 
然后 离开 了 对 话 。 

这 是 一 个 平衡 。 诀 窍 是 预测 未 来 的 对 话 ， 确 保 你 的 跟踪 系统 能 够 轻易 地 回答 你 的 问题 。 或 
许 你 希望 以 后 避免 有 开发 者 要 求 你 在 作出 决定 之 后 再 重复 一 遍 对 话 的 情况 。 在 这 种 情况 
下 ， 你 会 希望 工 单 系统 能 够 展示 双方 (通过 评论 ) 讨论 的 进展 、 最 终 的 结论 和 决定 变 成 代 
码 后 对 应 的 提交 链接 。 或 许 你 正在 构建 的 软件 遵从 业界 规定 的 监督 ， 你 需要 证 明 这 个 软件 
经 历 了 特定 的 评审 过 程 。 在 这 种 情况 下 ， 你 的 软件 仓库 中 包括 了 有 单独 的 质量 保证 测试 员 
签名 的 提交 就 足够 了 。 

我 不 认为 有 哪个 系统 在 跟踪 软件 开发 上 做 得 更 好 。 很 多 系统 既 有 优点 ， 又 有 缺点 。 如 果 你 
使 用 了 特定 的 流程 管理 哲学 ， 其 中 提倡 特定 的 任务 工作 流 ， 那 么 你 可 能 会 觉得 为 该 流程 优 
化 过 的 软件 产品 更 易于 使 用 。 例 如 ， 看 板 (Kanban) 是 一 个 处 理 任务 的 具体 例子 。 

大 多 数 Git 托管 平台 都 自 带 一 个 基本 的 工 单 跟踪 工具 来 帮 你 协调 项 目的 开发 。 第 三 部 分 将 
更 详细 地 介绍 其 中 三 个 系统 (Bitbucket, GitHub 和 GitLab)。 


4.2 工 单 进展 


即使 你 在 没有 固定 期 限 的 内 部 项 目 中 工作 ， 我 仍然 建议 选取 一 小 段 时 间 ， 周 而 复 始 地 进 
行 。 我 个 人 的 偏好 是 每 周一 个 冲刺 。 对 于 内 部 项 目 来 说 ， 这 些 冲 刺 可 以 充当 激励 团队 不 
断 前 进 的 任何 最 后 期 限 。 在 每 个 冲刺 最 后 ， 我 建议 组 织 一 次 内 部 展示 ， 展 现 自己 的 工 
作 。 公 开 的 展示 会 促使 开发 者 对 自己 的 工作 负责 。 如 果 你 的 团队 是 分 布 式 的 ， 那 可 以 
TE Google Hangout (http://www.google.com/+/learnmore/hangouts/)， 或 者 适合 更 大 团队 的 
GoToMeeting (http://www.gotomeeting.com/) 上 托管 这 些 展示 。 


跟踪 成 员工 作 的 项 目 方法 都 是 由 下 面 这 些 基 本 概念 发 展 而 来 的 。 
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尚未 开始 

在 Scrum 术语 中 ， 它 称 为 产品 积压 工作 (product backlog)。 本 质 上 ， 这 是 与 当前 工作 
(或 者 冲刺 ) 无 关 的 事情 。 开 发 者 不 应 该 从 这 个 列表 中 挑 工 单 来 做 。 积 压 工 作 应 该 按 优 
先 级 排序 ， 提 示 团 队 哪些 应 该 在 下 个 工作 冲刺 中 开始 做 。 最 近 ， 我 工作 过 的 一 个 团队 将 
它 称 为 一 堆 “ 以 后 非常 非常 重要 ”的 工 单 。 

准备 开工 

当前 工作 周期 中 安排 过 优先 级 的 工 单 。 这 些 工 单 可 能 是 积压 工作 表 中 积压 的 工 单 ， 也 可 
能 只 是 团队 挑选 出 将 要 开始 做 的 工 单 。 你 的 团队 可 能 希望 将 这 个 阶段 分 成 几 个 子 类 别 ， 
Au: 准备 开发 、 准 备 代码 评审 、 准 备 测 试 、 准 备 客户 批准 和 准备 部 署 。 

进行 中 

开发 者 正在 做 的 工 单 ， 或 正在 进行 质量 保证 评审 的 工 单 。 在 更 大 的 团队 中 ， 你 可 能 希望 
同样 细 化 这 个 类 别 。 例 如 : 制定 中 、 开 发 中 、 测 试 中 。 

已 完成 

工作 已 经 完成 或 被 取消 的 工 单 。 或 许 还 会 有 后 续 的 工 单 ， 但 在 经 过 代码 评审 、 质 量 保证 
评审 和 客户 评审 之 后 ， 工 单 几乎 不 会 被 重启 。 

不 要 让 项 目 经 理 过 度 细 化 分 类 

允许 团队 逐渐 添加 需要 的 状态 。 我 在 很 多 项 目 里 见 到 过 这 种 情况 ， 项 目 经 理 
在 描述 了 所 有 可 能 状态 的 一 大 堆 分 类 中 做 决定 。 这 样 的 系统 使 用 起 来 是 繁琐 
不 便 的 。( 我 是 一 个 喜欢 分 类 的 经 理 ! ) 开发 者 从 来 不 喜欢 记 住 要 微调 他 们 
的 工 单 状态 ， 大 多 数 情况 下 ， 这 些 工 单 的 状态 都 是 错误 的 ， 除 非 项 目 经 理 自 
己 在 状态 之 间 移 动工 单 。 要 理解 开发 者 想 要 将 宝贵 的 时 间 用 在 开发 而 不 是 更 
新 时 间 表 和 微调 工 单 更 新 上 。 那 就 从 简单 的 做 起 ， 使 用 尽 可 能 少 的 类 别 ， 当 
开发 团队 需要 新 的 状态 时 再 添加 。 





























































































































举 一 个 稍 有 变化 的 例子 。2014 年 秋季 我 合作 的 团队 有 九 个 人 ， 在 项 目 过 程 中 使 用 工 单 跟踪 
工具 〈 一 个 相对 小 的 项 目 ， 却 是 敏捷 项 目 常见 的 团队 大 小 )。 工 单 跟踪 工具 包含 以 下 状态 
的 摘要 栏 。 














准备 齐全 

这 类 工 单 准备 开始 做 ， 且 应 该 在 本 周 完成 。 

进行 中 

这 类 工 单 正在 活跃 地 进行 中 。 

合并 请 求 

代码 已 经 完成 ， 等 待 评审 后 并 入 主 分 支 。 

需要 测试 

代码 已 通过 评审 ， 并 被 推送 到 开发 分 支 。 准 备 在 质量 保证 服务 器 上 接受 团队 成 员 的 测试 。 
已 完成 

工 单 已 完成 。 这 个 状态 也 包括 已 关闭 但 未 完成 的 工 单 (重复 的 任务 、 不 再 需要 的 功能 )。 
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产品 积压 工作 只 是 一 堆 没 有 分 配 状 态 的 工 单 。 

如 有 果 开 发 者 遇 到 了 解决 不 了 的 问题 ， 他 应 该 将 这 个 工 单 重新 分 配给 最 有 可 能 “解决 ”这 个 
问题 的 人 。 和 别人 交换 工 单 的 习惯 是 文化 的 一 部 分 ， 不 可 能 适用 于 所 有 团队 ， 但 它 对 于 分 
布 式 团队 来 说 确实 表现 良好 ， 因 为 在 这 样 的 团队 中 你 无 法 做 到 拍 拍 别人 的 肩膀 就 能 解决 你 
的 问题 。 

我 比 一 般 的 开发 者 更 喜欢 分 类 系统 。 然 而 ， 增 加 复杂 度 是 有 后 果 的 。 复 杂 度 的 提升 会 增加 
人 们 决定 将 工 单 放 入 哪个 类 别 的 时 间 (这 个 工 单 应 该 是 需要 测试 呢 ， 还 是 合并 请 求 )。 它 
同时 增加 了 开发 者 在 工 单 系 统 中 花费 的 时 间 ， 而 不 是 在 自己 的 代码 编辑 器 上 。 它 潜在 地 
同时 提升 了 与 其 他 开发 者 沟通 的 时 间 ， 并 减 慢 了 真正 做 事 的 速度 。 你 需要 时 刻 提防 这 种 现 
象 ， 找 到 改进 方案 来 优化 你 的 流程 。 

选择 你 自己 擅长 的 工 单 

在 我 工作 过 的 团队 中 ， 开 发 者 能 够 自行 分 配 一 些 自己 的 工 单 ， 这 么 做 的 反馈 
良好 。 当 然 了 ， 可 能 有 一 些 工 单 需要 某 个 人 特殊 的 知识 ， 但 一 个 人 发 现 自己 
可 以 完成 这 个 工 单 与 要 求 他 去 做 什么 的 状态 之 间 存 在 的 差异 是 令 人 惊叹 的 。 








































































































与 团队 成 员 增 加 沟通 永远 都 不 嫌 多 。 我 不 是 指 将 自己 的 时 间 排 满 而 没有 组 织 会 议 。 我 的 意 
思 是 真正 地 交流 你 们 正在 做 的 工作 ， 有 什么 问题 阻止 了 你 完成 这 些 任务 。 工 单 状态 帮助 你 
将 沟通 标准 化 ， 这 会 使 保持 同步 更 加 容易 ， 并 确保 团队 中 每 个 人 养 成 每 天 确认 一 次 工 单 状 
态 的 习惯 。 


4.3 基本 工作 流 


这 个 基本 工作 流 适 合 拥有 一 至 二 个 可 信 开 发 者 的 团队 。 正 如 介绍 中 提 到 的 ， 这 是 GitFlow 
流程 的 一 个 简化 版 本 。 它 在 不 增加 复杂 度 的 情况 下 ， 整 合 了 功能 分 支 的 工作 流 。 因 此 ， 你 
会 发 现 这 个 工作 流 对 于 拥有 测试 设施 的 开发 团队 ， 也 就 是 致力 于 快速 部 署 代码 的 团队 来 说 
表现 民 好 。 

关键 特征 包括 以 下 这 些 。 

。 治理 模型 : 贡献 者 共同 维护 

。 集成 合并 : 由 原 开 发 者 执行 

。 整合 分 支 : develop 

我 使 用 这 种 工作 流 时 的 个 人 偏好 接近 于 看 板 风 格 的 系统 ， 后 者 允许 工 单 在 一 个 工作 板 上 流 
动 ， 但 是 ， 我 发 现在 时 间 固 定 的 冲刺 中 使 用 Scrum 方法 ， 与 外 部 利益 干系 人 的 沟通 计划 会 
更 容易 。 在 Scrum 中 ， 一 组 工 单 进入 一 个 冲刺 ， 我 们 的 目标 是 在 最 后 期 限 前 将 存在 的 工 单 
数量 降 至 0。 对 于 内 部 项 目 来 说 ，Scrum 风格 的 冲刺 计划 可 以 充当 保持 团队 不 断 进 步 的 任 
意 最 后 期 限 。 


在 每 个 冲刺 后 ， 我 建议 举行 一 个 内 部 展示 会 ， 让 团队 展现 他 们 的 工作 ， 如 果 他 们 卡 在 了 茶 
个 特定 问题 上 ， 可 以 向 更 多 人 求助 。 
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这 个 工作 流 如 下 所 示 。 

(1) 当 你 开始 一 个 工 单 时 ， 在 工 单 跟踪 工具 中 更 新 状态 ， 比 如 将 它 标 记 为 正在 进行 。 这 会 通 

知 你 的 团队 你 正在 进行 的 工作 ， 并 告诉 你 为 了 完成 这 个 工 单 你 需要 创建 的 分 支 数量 。 

(2) 从 develop 分支 上 创建 一 个 命名 包含 工 单 编号 和 大 致 的 工作 描述 的 新 分 支 。 如 果 你 正在 
进行 的 工 单 拥有 子 任务 ， 这 个 工 单 在 你 的 工 单 系 统 中 可 能 称 为 元 工 单 或 Epic 工 单 。 如 
果 你 的 工作 只 是 未 来 工作 的 一 部 分 ， 你 应 该 使 用 相关 最 小 的 工 单 号 。 你 的 工 单 系统 可 能 
会 将 这 些 工 单 称 为 用 户 故 事 、issue 或 bug TH, 

(3) 在 你 开始 工作 后 ， 确 保 每 次 可 能 将 更 改 并 和 master 分 支 之 前 ， 工 单 分 支 能 够 保持 最 新 
状态 。 每 个 提交 说 明 都 以 包含 工 单 号 的 方 括号 开头 : [331234], 

(4) 运行 相关 的 测试 ， 保 证 你 的 代码 中 的 拼写 错误 和 常见 错误 都 能 被 发 现 。 这 一 步 可 能 包括 
一 个 拼写 检查 、 一 个 语法 检查 (通过 Lint 进行 静态 语法 检查 )。 如 果 你 在 测试 驱动 的 环 
境 中 工作 ， 那 么 一 定 会 有 额外 的 测试 需要 运行 。 

(5) 当 你 完成 工作 (或 是 你 认为 你 完成 了 ! ) 的 时 候 ， 上 传 最 后 一 个 提交 ， 包 含 关键 词 
resolves (解决 )， 后 跟 工 单 号 : Resolves #1234, 

(6) 可 以 选择 将 你 的 工 单 分 支 推送 到 代码 托管 仓库 。 使 用 提交 说 明 中 的 关键 字 ， 这 一 推送 会 
将 你 的 工 单 跟 踪 工 具 带 入 下 一 步 。 

(7) 用 你 的 工 单 跟踪 工具 为 这 个 工 单 添加 一 条 评论 ， 说 明 你 使 用 某 个 方法 的 原因 ， 并 证 明 工 
作 已 经 完成 。 例 如 ， 添 加 一 张 屏幕 截图 ， 显 示 在 你 的 本 地 开发 环境 中 这 个 工 单 引起 了 哪 
些 变化 。 如 果 无 法 正常 工作 了 ， 这 一 步 在 后 面 就 会 变 成 可 用 性 测试 。 

(8) 确保 工 单 分 支 保持 最 新 ， 然 后 将 你 的 工作 合并 到 develop 分支 ,假设 没有 合并 冲突 ， 将 
更 新 后 的 分 支 推送 到 中 央 仓 库 。 

(9) 假设 新 添加 的 工作 没有 带 来 任何 新 的 问题 (回归 ) ， 这 个 工 单 就 可 以 关闭 了 。 

(10) 最 后 ， 删 除 你 本 地 的 工 单 分 支 和 这 个 工 单 分 支 的 远程 副本 。 


在 一 些 工 单 系 统 中 ， 添 加 一 个 井 号 (#) 会 自动 将 提交 说 明和 工 单 号 关联 起 
来 。 在 工 单 号 周围 添加 方 括号 可 以 保证 在 你 选择 变 基 你 的 工作 时 ， 提 交 说 明 
不 会 被 忽略 ， 因 为 在 自动 生成 新 的 提交 对 象 时 ， 以 # 开头 的 行 会 变 成 注释 而 
被 忽略 。 在 很 多 系统 中 ， 包 含 关键 词 resolves 将 会 自动 把 工 单 从 正在 进行 移 
至 下 一 状态 (例如 ， 需 要 测试 或 关闭 )。 这 一 点 取决 于 你 在 使 用 的 工 单 系统 ， 
不 管 你 使 用 哪个 系统 ， 查 看 它 的 文档 即 可 。 















































































































































这 个 模式 对 于 没有 同行 评审 的 小 团队 来 说 表现 非常 好 。 随 着 团队 开始 扩大 或 者 需要 经 历 特 
定 的 质量 保证 过 程 ， 你 会 发 现 这 个 模式 并 不 能 完全 满足 你 的 要 求 。 


4.3.1 使 用 同行 评审 的 可 信 开 发 者 

这 个 工作 流 与 最 基本 的 团队 工作 流 相 比 ， 增 加 了 一 个 同行 评审 环节 。 现 在 ， 每 个 工 单 都 由 
另 一 个 团队 成 员 从 代码 的 角度 进行 评审 。 使 用 同行 评审 测试 ， 而 不 只 是 自动 化 测试 (或 测 
试 驱动 开发 ) 的 原因 将 在 第 8 章 中 介绍 。 


关键 特征 包括 以 下 这 些 。 
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。 治理 模型 : 贡献 者 共同 维护 
。 集成 合并 : 由 审查 者 执行 
。 集成 分 支 : develop 

这 个 工作 流 如 下 所 示 。 


(1) 当 你 开始 一 个 工 单 时 ， 在 工 单 跟踪 工具 中 更 新 状态 ， 表 示 这 个 工 单 已 经 在 进行 中 了 。 

(2) 从 develop 分支 的 本 地 副本 上 创建 一 个 新 的 分 支 。 

(3) 进行 你 的 工 单 ， 使 用 变 基 来 确保 你 的 分 支 是 最 新 的 。 每 个 提交 说 明 都 以 包含 工 单 号 的 方 括 
号 开头 〈[ 刀 234] ) ， 或 是 以 关键 词 resolves (解决 ) 开头 ， 后 跟 工 单 号 : Resolves $1234, 

(4) 运行 相关 的 测试 ， 保 证 你 的 代码 中 的 拼写 错误 和 和 常见 错误 都 能 被 发 现 。 这 一 步 可 能 包括 

个 拼写 检查 、 一 个 语法 检查 (通过 Lint 进行 静态 语法 检查 )。 如 果 你 在 测试 驱动 的 环 
境 中 工作 ,一 定 会 有 额外 的 测试 需要 运行 。 

(5) 将 你 的 代码 推送 到 代码 托管 仓库 。 这 是 你 的 备份 ， 所 以 不 要 跳 过 这 一 步 。 

(6) 当 你 完成 这 个 工 单 时 ， 确 保 工 单 分 支 与 develop 保持 同步 ， 然 后 将 你 的 工作 上 传 至 代码 
托管 系统 。 在 工 单 跟踪 工具 中 将 工 单 标记 为 需要 测试 。 

如 果 需 要 手动 评审 ， 而 且 疫 有 完善 的 自动 化 测试 ， 评 审 者 将 要 完成 以 下 剩余 步骤 。 

(QD) 根据 原始 的 工 单 描述 对 工作 进行 一 次 评审 。 编 码 者 有 义务 保证 自己 的 工作 是 清晰 的 ， 与 
测试 工作 的 步骤 是 密切 相关 的 。 如 果 有 需要 ， 将 这 个 工 单 发 回 开发 者 进行 必要 的 修改 ， 
或 者 在 与 develop 失去 同步 时 更 新 分 支 。 

(2) 合并 工 单 分 支 和 develop ZZ, 假设 没有 合并 冲突 ， 将 更 新 后 的 分 支 推 送 到 中 央 仓 库 。 

(3) 假设 没有 出 现 回归 ， 评 审 者 会 关闭 工 单 ， 通 知 开发 者 他 的 工作 已 经 并 入 主 分 支 。 开 发 者 
和 评审 者 现在 都 可 以 删除 他 们 本 地 的 工 单 分 支 的 副本 。 因 为 他 们 现在 正在 清理 ， 所 以 评 
审 者 应 该 删除 工 单 分 支 的 远程 副本 ， 开 发 者 可 能 需要 停 下 当前 的 工作 来 完成 清理 。 无 论 
何 时 ， 我 们 都 应 该 保持 专注 ， 维 护 流程 ， 保 护 团 队 成 员 。 

当 团 队 大 到 拥有 评审 流程 时 ， 建 立 一 台 共 享 的 开发 服务 器 就 很 有 用 了 ， 团 队 可 以 实施 定期 

的 工作 展示 。 在 开发 过 程 中 ， 开 发 服务 器 同时 可 以 兼 做 质量 保证 机 器 。 为 了 减少 团队 成 员 

检查 develop 分支 的 最 新 版 本 以 及 构建 软件 的 开销 ， 你 可 以 选择 搭建 一 个 Jenkins (http:// 

jenkins-ci.org/) 实例 来 使 这 个 流程 自动 化 。 


4.3.2 ”需要 质量 保证 团队 的 不 可 信 开 发 者 

这 个 过 程 在 4.3.1 节 之 上 做 了 一 些微 小 的 变化 。 这 次 ， 我 们 假设 有 一 个 不 可 信 的 开发 者 ， 
不 允许 将 任何 人 的 工作 并 入 主 分 支 。 相 反 ， 一 个 可 信和 的 质量 保证 团队 执行 最 终 的 合并 。 
关键 特征 包括 以 下 这 些 。 

。 治理 模型 : 具有 并 置 仓库 的 贡献 者 

。 集成 合并 : 由 评审 者 执行 

。 集成 分 支 : develop 


开发 者 在 代码 托管 系统 中 派生 一 份 项 目 来 开始 工作 ， 然 后 在 本 地 克隆 这 份 仓库 的 派生 副 
本 。 这 一 步 只 执行 一 次 。 
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这 个 工作 流 如 下 所 示 。 

(1) 当 你 开始 一 个 工 单 时 ， 在 工 单 跟踪 工具 中 更 新 状态 ， 表 示 这 个 工 单 已 经 在 进行 中 了 。 

(2) 从 develop 分支 的 本 地 副本 上 创建 一 个 新 的 分 支 。 

(3) 进行 你 的 工 单 ， 使 用 变 基 来 确保 你 的 分 支 是 最 新 的 。 将 你 的 工 单 分 支 推送 到 你 派生 的 项 
目 中 ， 作 为 进行 中 工作 的 备份 。 

(4) 运行 相关 的 调试 ， 保 证 你 的 代码 中 的 拼写 错误 和 常见 错误 都 能 被 发 现 。 这 一 步 可 能 包括 
个 拼写 检查 、 一 个 语法 检查 (通过 Lint 进行 静态 语法 检查 )。 如 果 你 在 测试 驱动 的 环 
漠 中 工作 ， 一 定 会 有 额外 的 测试 需要 运行 。 

(5) 当 你 完成 这 个 工 单 时 ， 确 保 工 单 分 支 与 develop 保持 同步 ， 然 后 将 你 的 工作 推送 到 你 派生 
的 仓库 中 。 为 你 的 工作 打开 一 个 拉 取 请 求 ( 在 一 些 工 单 系统 中 ， 它 可 能 称 为 合并 请 求 )。 


评审 者 将 要 完成 以 下 剩余 步 又 。 


(1) 根据 原始 的 工 单 描述 对 工作 进行 一 次 评审 。 

(2) 在 仓库 的 主 副本 中 接受 拉 取 请 求 。 根 据 你 的 工 单 系统 ， 这 一 步 可 能 在 网 页 的 图 形 化 界面 
上 完成 ， 也 可 能 在 仓库 的 本 地 克隆 中 完成 。 

(3) 假 设 没 有 出 现 回归 ， 评 审 者 关闭 工 单 。 因 为 工作 是 在 派生 项 目 中 完成 的 ， 所 以 主 仓库 中 
不 需要 额外 的 清理 。 


如 果 你 的 团队 中 大 多 数 都 是 可 信 的 开发 者 ， 但 也 有 一 些 合约 雇员 ， 这 个 方法 同样 表现 良 
好 。 你 可 能 会 希望 你 的 合约 雇员 在 派生 仓库 中 工作 ， 而 不 是 给 他 们 主 项 目的 写 入 权限 。 在 
一 些 类 型 的 软件 中 ， 甚 至 你 的 员工 之 间 也 有 这 样 的 分 割 。 例 如 ， 如 果 你 在 为 一 个 医疗 设备 
开发 固件 ， 则 可 能 需要 遵守 非常 严格 的 政府 规定 ， 限 制 工作 雇员 的 权限 提交 ， 在 将 工作 添 
加 至 仓库 之 前 确保 评审 的 执行 。 


4.4 根据 计划 发 布 软件 


我 工作 过 的 大 部 分 项 目 使 用 发 布 计 划 来 将 新 版 本 软件 呈现 给 用 户 。 本 节 介 绍 的 这 个 过 程 
几乎 完全 基于 流行 的 GitFlow (http://nvie.com/posts/a-successful-git-branching-model/) 工作 
流 。 如 果 你 应 用 了 持续 集成 ， 没 有 将 多 个 工 单 的 工作 放 入 一 次 发 布 中 ， 那 么 可 以 跳 过 本 而 
内 容 。 


4.4.1 发 布 稳定 版 本 


至 此 为 止 ， 所 有 的 例子 中 我 们 都 在 develop 分支 上 工作 。 不 过 ， 最 终 你 要 将 一 直 工 作 的 产 

品 发 布 出 去 。 当 你 准备 好 发 布 时 ， 需 要 将 你 的 仓库 分 成 一 个 面向 公众 的 稳定 版 本 ， 和 一 个 

面向 开发 者 的 “无 保证 ”的 版 本 。 

这 个 工作 流 如 下 所 示 。 

(D 从 一 个 基本 的 提交 开始 ， 创 建 一 个 名 为 master 的 新 分 支 。 

(2) 使 用 易于 记忆 的 命名 约定 给 这 个 提交 打上 一 个 版 本 号 标签 。 例 如 ，v1.0。 

O 将 更 新 后 的 仓库 推送 到 集中 式 代 码 托管 系统 。 如 果 没 有 使 用 自动 化 构建 过 程 ， 就 使 用 新 
的 代码 更 新 相关 的 服务 器 。 
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在 第 一 个 发 布 完成 后 ， 你 现在 可 以 将 工作 切 分 为 稳定 、 面 向 公众 的 工作 和 正在 进行 的 
开发 。 


4.4. 正在 进行 的 开发 

在 产品 的 官方 发 布 之 后 ， 你 的 团队 将 会 立即 开始 同时 考虑 两 个 不 同 的 环境 : 监控 线 上 代码 
的 健康 状况 ， 同 时 继续 开发 ， 添 加 新 的 功能 或 改善 已 有 的 功能 

我 的 偏好 依然 是 使 用 短小 的 冲刺 周期 。 看 到 自己 的 工作 成 果 ， 开 发 者 会 充满 动力 。 冲 刺 周 
期 越 长 ， 等 待 别 人 接触 到 他 们 的 工作 成 果 的 时 间 就 越 长 。 


我 通常 使 用 的 一 周 发 布 计划 有 着 固定 的 路 线 。 对 于 不 同 团队 来 说 ， 天 数 可 能 有 所 差别 ， 但 

这 个 通用 的 方法 对 很 多 团队 来 说 都 是 一 个 好 的 出 发 点 。 

设置 (周一 ) 的 工作 内 容 如 下 所 示 。 

。 所 有 develop 分 支 上 的 工作 并 入 测试 分 支 gg。 周一 前 没有 完成 及 没有 经 过 同行 评审 的 工 
作 只 需要 留 在 原来 的 工 单 分 支 即 可 。 

。 将 测试 服务 器 更 新 至 qa 分 支 的 最 新 版 本 。 

。 为 上 周 完成 的 所 有 用 户 故 事 创 建 一 个 QA 清单 。 使 用 标准 化 的 工 单 格式 很 容易 编写 这 
清单 。 


你 可 能 希望 在 一 个 单独 的 文档 中 编写 你 的 QA 清单 ， 如 Google Doc 或 内 部 Wiki。 我 同时 

使 用 JIRA 中 保存 的 查询 来 寻找 上 周 已 解决 的 工 单 ， 或 被 标记 到 某 个 发 布 的 工 单 。 这 完全 

取决 于 你 在 你 的 工 单 系统 中 如 何 选择 跟踪 流程 。 

测试 (周一 和 周二 ) 的 工作 内 容 如 下 所 示 。 

。 运行 自动 化 测试 ， 确 保 关 键 业务 的 交互 没有 出 现 回 归 (网 站 访问 者 和 会 员 仍然 可 以 使 用 
预期 的 功能 ) 。 

。 团队 成 员 负 责 测 试 清 单 中 的 所 有 项 目 , 并 将 工 单 的 状态 更 新 为 PASS( 通 过 ) 或 FAIL( 失 败 )。 

。 任何 发 现 的 bug 都 应 该 打开 新 的 工 单 ， 并 在 发 布 日 前 提出 ， 要 么 通过 新 的 修复 解决 ， 要 
么 从 qa 分 支 上 移 除 相关 的 提交 

发 布 日 (周三 ) 的 工作 内 容 如 下 所 示 。 

。 将 ga 分 支 并 入 master 分支 ， 打上 发 布 版 本 的 标签 。 

。 通过 签 出 master 分 支 上 的 提交 ， 也 就 是 项 目 最 新 的 发 布 ， 更 新 线 上 网 站 。 使 用 显 式 标 
签 确保 你 可 以 轻松 退回 到 先前 的 状态 。 

将 新 功能 和 修复 的 公告 发 布 到 开发 博客 。 很 多 团队 选择 在 发 布 日 后 等 待 一 至 两 天 再 发 布 博 

客 上 的 文章 。 团 队 能 够 确定 这 个 发 布 稳定 ， 不 需要 回 滚 。 


4.4.8 发 布 后 的 补丁 


有 时 部 署 的 代码 存在 错误 。 如 果 一 个 bug 需要 在 下 次 软件 发 布 前 得 到 快速 修复 ， 这 时 就 需 
要 进行 一 个 计划 外 的 修复 。 这 些 部 署 通常 称 为 补丁 。 
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在 补 本 中， 工作 不 是 从 develop 分 支 开始 ， 而 是 从 master 分 支 开 始 ， 确 保 更 改 只 引入 了 部 

署 代 码 中 发 现 的 问题 的 修复 。 

这 个 工作 流 如 下 所 示 。 

(1) 创建 一 个 补丁 分 支 ， 签 出 master 分 支 ， 而 不 是 develop 分 支 ， 确 保 没 有 意外 地 将 额外 
的 功能 加 入 这 次 修复 。 

(2) 生成 标签 名 的 列表 ， 定 位 到 最 新 打上 标签 的 发 布 。 

(3) 从 naster 最 新 打上 标签 的 发 布 上 ， 创 建 一 个 新 的 分 支 ， 使 用 hotfix- <ticket_number>- 
«descriptions 格式 的 分 支 名 。 例 如 ，hotfix-1234-fixing_three_seat_issue。 

(4) 完成 与 开发 工 单 相同 的 评审 步骤 。 

(5) 将 通过 测试 的 补丁 分 支 并 入 master 分 支 。 

(6) 将 master 分 支 上 的 最 新 提交 打上 最 新 发 布 的 版 本 号 。 例 如 ，v1.0.1。 

CD) 将 经 过 测试 的 补丁 分 支 并 入 开发 分 支 ， 保 证 在 下 次 软件 正式 发 布 时 这 些 修 改 不 会 丢失 。 


4.5 非 软 件 项 目 中 的 协作 


Git 不 只 是 软件 开发 者 的 专利 ! 作为 技术 作家 ， 我 使 用 Git 来 跟踪 不 是 软件 的 文件 ， 例 如 ， 
配置 文件 、 正 在 编写 的 文章 ， 甚 至 是 这 本 书 ! 有 人 甚至 使 用 Git 来 维护 个 人 日 记 。 为 了 说 明 
将 Git 命令 与 团队 流程 一 一 对 应 的 重要 性 ， 让 我 来 解释 一 下 我 是 如 何 组 织 这 本 书 的 仓库 的 。 
在 写 这 本 书 时 ， 我 使 用 的 是 O'Reilly 的 自动 化 构建 工具 Atlas (https://atlas.oreilly.com/) 。 
这 个 系统 还 提供 了 一 个 网 页 ， 使 得 编辑 可 以 直接 在 上 面 操作 图 书 文件 ， 保 存 的 文件 被 立即 
提交 到 master 分 支 。 界面 上 没有 同行 评审 流程 ， 因 为 我 的 团队 中 任何 人 都 可 以 直接 编辑 一 
份 文件 。 然 而 ， 我 偏好 在 本 地 工作 ， 而 不 是 通过 网 页 。 最 初 ， 我 一 直 在 master 上 工作 ， 本 
地 的 分 支 开销 很 低 。 直 到 一 次 出 现 的 合并 冲突 改变 了 我 在 本 地 的 工作 方式 。 


当 我 想 要 更 新 我 的 工作 时 ， 我 会 使 用 fetch 命令 来 查看 我 的 编辑 做 出 的 修改 。 通 过 fetch 
命令 ， 我 将 我 的 master 分 支 的 副本 与 他 们 的 master 分 支 的 副本 (origin/master) 相 比较 。 
假设 我 同意 编辑 做 出 的 所 有 修改 ， 我 会 把 他 们 的 分 支 副 本 并 入 我 本 地 的 副本 ， 如 果 我 有 异 
议 ， 我 会 使 用 --strategy-option=ours 策略 来 合并 他 们 的 分 支 ， 即 丢掉 他 们 的 修改 ， 但 是 
让 Git 以 为 这 两 个 分 支 已 经 合并 。 
上 面 的 做 法 是 基于 提交 层面 的 ， 如 果 出 现 了 合并 冲突 ， 你 还 可 以 使 用 合并 工具 来 进行 细 粒 
度 的 逐 行 修改 。( 将 东西 直接 丢掉 听 上 去 有 些 像 被 动 的 攻击 ， 但 这 只 是 单 分 支 系统 的 限制 ， 
你 无 法 在 单独 的 分 支 中 讨论 提议 的 更 改 。) 根据 提交 的 粒度 ， 我 或 许 还 会 选择 cherry-pick 
一 些 命令 (并 保留 他 们 )， 但 丢弃 其 他 提交 。 

然后 你 开始 收 到 PDF 格式 的 评审 意见 ， 我 又 一 次 意识 到 ， 我 还 有 另 一 种 分 离 工作 的 方式 。 
我 想 要 新 写 一 章 ， 并 保持 这 些 提交 干净 整洁 ， 但 有 时 候 我 一 章 正 写 到 一 半 ， 进 来 了 一 份 编 
辑 修改 ， 我 希望 及 时 处 理 。 我 设置 了 如 下 的 分 支 结构 : master、drafts， 以 及 每 章 单独 的 
一 个 分 支 。 
drafts 分 支 让 我 能 够 整合 我 正在 进行 的 所 有 工作 。 它 通过 合并 已 完成 的 章节 来 保持 同步 ， 
或 是 在 编辑 进行 修改 后 变 基 master 分 支 。 当 我 自己 编写 章节 ， 没 有 其 他 人 的 贡献 时 ， 多 分 
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支 会 产生 高 昂 的 维护 成 本 ， 但 当 越 来 越 多 的 贡献 者 开始 提供 不 同类 型 的 贡献 时 ， 更 细 的 分 
支 粒度 使 我 能 够 选择 如 何 更 新 我 的 稿子 。 
正如 你 所 看 到 的 ， 我 的 流程 和 软件 项 目 使 用 的 工作 流 截 然 不 同 ， 但 我 用 的 同样 是 Git! 你 
的 工作 可 能 有 自己 的 特点 ， 需 要 非 标 准 化 的 分 支 。 不 要 害怕 尝试 ， 当 你 尝试 时 ， 将 你 的 流 
程 记录 下 来 ， 让 别人 能 够 理解 预期 的 影响 。 


4.6 1M 


本 章 描述 的 工作 流 在 我 工作 过 的 团队 中 已 经 取得 了 成 功 的 实践 。 你 自己 的 团队 或 许 希 望 进 

行 一 些 调整 ， 但 有 这 样 一 个 参考 总 比 从 零 开 始 要 好 。 

。 你 使 用 的 工作 流 在 产品 发 布 前 后 可 能 变动 。 

。 在 发 布 前 ， 你 可 能 拥有 更 少 的 集成 分 支 ， 因 为 不 太 可 能 出 现 补丁 的 概念 。 

。 通过 使 用 你 的 文档 来 完成 工作 ， 你 确保 你 的 文档 总 是 最 新 的 ， 这 样 在 你 需要 帮助 时 ， 其 
他 同事 可 以 更 快 上 手 。 

在 第 二 部 分 中 ， 你 将 学 到 实现 本 章 摘 述 的 流程 需要 的 命令 。 
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第 二 部 分 
在 工作 流 中 使 用 命令 





在 本 书 的 这 一 部 分 中 ， 我 们 从 实践 的 角度 来 学 习 Git 命令 。 首 先 会 给 出 一 个 场景 ， 然 后 会 
给 你 一 些 让 自己 陷入 (摆脱 ) 困境 的 命令 。 

本 章 随 处 可 见 需 要 上 和 手 实践 的 活动 。 在 可 能 的 情况 下 ， 你 应 该 完成 这 些 活动 ， 因 为 这 能 帮 
助 你 深入 理解 命令 (并且 在 从 事 自 己 的 软件 项 目 时 ， 你 也 会 觉得 相应 的 消息 更 加 自然 )。 
当 提 供 了 图 表 时 ， 你 应 该 自己 重新 绘制 一 遍 ， 因 为 每 当 你 学 习 一 个 新 的 活动 时 ， 你 的 一 举 
一 动 都 会 帮助 你 在 脑 诲 中 强化 这 些 信息 。 
在 阅读 后 续 章 节 前 ， 你 应 该 确保 你 安装 了 最 新 版 本 的 Git (参见 附录 B)， 并 确保 你 的 系统 
已 经 配置 正确 (参见 附录 C). 
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单 人 团队 








尽管 这 本 书 是 面向 多 人 团队 的 ， 但 我 们 经 常 也 会 单 兵 奋 战 ， 即 作为 独立 开发 者 。 可 能 你 是 
在 做 自己 的 业务 项 目 ， 或 者 你 的 团队 中 只 有 你 一 个 开发 者 。 没 有 团队 约束 的 单 兵 奋战 或 许 
有 些 吓 人 ， 因 为 没有 人 会 告诉 你 应 该 做 什么 ， 或 是 在 你 陷 人 困境 时 帮 你 一 把 。 我 会 向 你 展 
示 我 在 做 自己 的 项 目 时 是 如 何 工 作 的 。 当 然 ， 有 些 时 候 我 偷懒 省 去 了 一 些 步 又。( 毕 竟 没 
有 人 监督 我 ， 所 以 谁 会 知道 我 走 了 捷径 呢 ? ) 在 可 能 的 地 方 ， 我 将 会 向 你 展示 这 些 捷径 的 
效果 。 


学 完 本 章 之 后 ， 你 将 具备 以 下 技能 。 


。 创建 一 份 远 程 仓库 的 本 地 副本 
。 为 现 有 的 文件 集 初始 化 版 本 控制 
。 从 空 的 项 目 目录 开始 创建 一 个 新 的 仓库 
。 通过 提交 消息 来 检查 仓库 历史 

。 通过 分 支 来 隔离 无 关 的 工作 

。 在 本 地 仓库 中 创建 提交 

。 使 用 标签 来 高 亮 单个 提交 

。 建立 你 的 项 目 与 远程 代码 托管 系统 的 连接 


如 果 你 是 一 个 创造 者 (相对 于 评审 者 或 管理 者 )， 那 么 你 的 大 部 分 时 间 应 该 花 在 使 用 本 章 
介绍 的 命令 上 。 应 当 将 熟练 使 用 这 里 介绍 的 所 有 工具 视 为 阅读 本 部 分 剩余 章节 的 前 提 。 
喜欢 通过 视频 教程 学 习 的 读者 可 以 参考 本 书 附 带 的 系列 视频 ，Collaborating with Git (http:/ 
shop.oreilly.com/product/0636920034872.do) 。 
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5.1 基于 issue 的 版 本 控制 


曾经 有 人 和 我 说 ， 最 擅长 描述 一 个 问题 的 人 最 有 可 能 能 够 解决 它 。 在 写 这 本 书 的 时 候 ， 我 
发 觉 这 个 观点 太 正 确 了 。 当 我 给 自己 写 下 一 个 模糊 不 清 的 待 办 事项 (TODO)， 比 如 “完成 


第 4 章 ” 时 ， 我 感到 几乎 没有 继续 写 下 去 的 动力 。 但 当 我 把 这 个 任务 描述 为 “为 Mai 这 样 











的 小 型 团队 编写 样 例 工作 流 ” 后 ， 我 更 腔 入 写作 的 动力 。 不 过 ， 这 不 仅 限 于 写 书 。 作 为 
单 人 团队 ， 你 可 能 没有 很 大 的 动力 来 编写 代码 。 不 过 ， 要 是 你 和 我 一 样 ， 如 果 做 的 事情 能 





够 帮助 别人 


你 或 许 会 问 











， 你 就 会 更 有 动力 把 这 件 事情 做 成 。 


如 果 你 从 未 思考 过 是 什么 激励 你 成 为 一 个 开发 者 ， 你 或 许 会 喜欢 Joe Shindelar 
的 演讲 “开发 者 眼中 的 开发 者 管理 ”(https://austin2014.drupal.org/session/ 


developers-primer-managing-developers.html ) , 








自己 “这 个 和 Git 有 什么 关系 "。 每 次 你 坐 下 来 ， 在 使 用 源码 管理 的 项 目 中 工作 











时 ， 你 应 该 对 你 所 做 的 事情 了 如 指 掌 。 无 论 你 是 在 开发 一 个 新 功能 ， 修 复 一 个 bug， 重 构 
旧 的 代码 ， 还 是 在 尝试 新 的 想法 ， 你 都 应 该 有 某 种 改进 动力 。 你 有 很 多 种 方式 将 想 做 的 事 
情 写 下 来 ， 但 下 面 介绍 的 方式 更 加 优雅 ， 与 只 是 用 到 工 单 相 比 ， 回 报 也 更 丰厚 。 


工 单 包含 以 下 三 个 主要 部 分 。 


。 问题 





大 致 描述 你 想 要 解决 的 问题 。 


。 原因 

















为 什么 你 想 要 做 这 件 事 (如果 问题 得 到 解决 ， 谁 将 受益 ) ? 
。 质量 保证 测试 

我 将 如 何 知道 这 个 问题 已 经 得 到 解决 ? 
这 种 格式 与 我 所 见 到 的 敏捷 项 目 使 用 的 另 一 种 格式 非常 相似 。 


。 卡片 


从 用 户 的 角度 ， 大 致 描述 这 个 问题 。 


。 对 话 


你 想 要 解决 的 问题 的 细节 。 在 可 能 的 情况 下 ， 应 该 避免 给 出 具体 的 解决 方案 。 


。 确认 


(第 一 部 分 中 的 ) 用 户 用 于 验证 问题 是 否 解决 的 步骤 。 





了 。 我 通常 


在 单 人 团队 中 ， 你 可 能 感觉 使 用 工 单 的 开销 对 你 来 说 大 了 些 。 或 许 你 的 记事 本 就 已 经 足够 
一 开始 也 这 样 认 为 ， 但 继续 做 项 目 时 ， 我 开始 不 断 地 忘记 一 些微 小 的 想法 。 有 


时 我 为 每 个 想法 创建 一 个 新 的 分 支 ， 但 最 后 被 一 大 堆 过 时 的 分 支 压 得 透 不 过 气 来 。 如 果 你 
有 同感 ， 请 现在 就 花 点 时 间 ， 找 到 你 使 用 的 代码 托管 系统 中 的 工 单 跟踪 选项 ， 然 后 渐渐 养 
成 习惯 ,记录 你 将 对 你 的 软件 所 做 的 工作 。 至 少 ， 它 会 给 你 一 些 用 于 创建 分 支 和 跟踪 代码 


的 编号 。 
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如 果 你 目前 还 没有 代码 托管 系统 ， 我 向 你 推荐 GitLab， 或 者 它 的 免费 在 线 
版 本 : GitLab.com。 你 可 以 免费 创建 不 限 合作 者 数量 的 私有 仓库 ， 如 果 你 在 
防火 墙 内 学 习 Git， 还 可 以 将 它 安装 在 局 域 网 中 。 私 有 仓库 的 优点 是 你 可 以 
在 学 习 时 隐藏 你 的 工作 。 如 果 别 人 看 不 到 你 的 工作 ， 你 将 不 能 得 到 社区 的 帮 
助 ， 但 我 觉得 你 可 能 现在 还 有 些 害羞 ， 不 会 去 社区 里 交流 。 对 于 我 们 大 多 数 
人 来 说 都 是 这 样 的 。 











一 旦 你 找到 一 种 跟踪 想 蔷 的 方式 ， 工 作 的 流程 应 该 遵循 以 下 步 又 。 


(1) 在 你 的 issue 跟踪 系统 中 创建 一 个 新 的 工 单 ， 注 明 这 个 issue 的 编写。 

@2) 在 你 的 本 地 仓库 中 ， 使 用 issuenunber-description 格式 创建 一 个 新 的 分 支 。 

(3) 完成 工 单 描述 的 工作 ( 且 只 完成 工 单 中 描述 的 工作 )。 

(4) 测试 你 的 工作 ， 确 保 已 经 完成 并 且 是 正确 的 。 确 保 它 能 够 通过 开发 环境 下 的 QA 测试 。 

(3) 现 在 ， 你 有 了 一 个 “杂乱 ”的 工作 目录 ， 甚 中 包含 了 新 增 的 文件 和 (X) 修改 过 的 文 
件 。 将 你 的 更 改 添加 到 本 地 仓库 的 暂 存 区 。 

(6) 将 你 缓存 的 修改 提交 至 仓库 。 

0) 将 你 的 更 改 推送 到 备用 服务 器 上 。 在 很 多 情况 下 ， 这 也 将 是 追踪 你 的 工 单 的 地 方 ， 如 
GitLab, Bitbucket 或 GitHub。 根 据 你 的 工 单 系统 ， 现 在 可 以 将 这 个 工 单 标记 为 已 解决 ， 
但 不 需要 将 其 标记 为 已 关闭 。 

(8) 当 你 对 你 的 工作 完全 满意 时 ， 将 你 的 工 单 分 支 并 入 主 分 支 (通常 是 master) 并 将 修改 

后 的 分 支 推送 到 代码 托管 系统 中 。 

(9) 再 一 次 测试 你 的 工作 ， 确 保 没 有 后 续 问 题 。 

(10) 将 你 的 工 单 标记 为 已 关闭 。 

根据 你 正在 编写 的 代码 类 型 ， 这 些 步骤 可 能 略 有 不 同 。 推 翻 重 写 这 个 列表 ， 加 入 与 你 工作 

方式 不 同 的 所 有 步 又。 例如， 你 可 能 使 用 测试 驱动 开发 的 实践 ， 或 是 使 用 构建 脚本 来 部 署 

代码 。 使 用 你 自己 的 流程 。 如 果 你 不 习惯 使 用 文字 ， 请 画 出 你 的 流程 (图 5-1). 


不 管 你 选择 怎么 做 ， 确 保 记 下 你 的 流程 。 你 可 以 选择 在 仓库 的 README 文件 中 记录 这 些 ， 
或 是 打印 出 来 并 贴 在 你 的 看 板 上 。 通 过 遵守 一 致 性 约定 ， 与 同事 一 起 建立 每 个 人 都 能 遵守 
的 流程 将 变 得 无 比 轻松 。 

在 本 章 剩余 部 分 中 ， 你 将 学 到 之 前 描述 过 的 流程 中 需要 用 到 的 命令 。 我 们 将 会 从 创建 新 的 
仓库 开始 ， 你 可 以 在 此 存放 你 的 工作 。 


5.2 创建 本 地 仓库 


当 你 在 Git 中 创建 一 个 新 的 仓库 时 ， 一 般 会 从 以 下 三 个 起 点 之 一 开始 创建 。 


。 一 个 克隆 的 仓库 
。 一 个 文件 未 被 跟踪 的 文件 夹 


。 一 个 空 目录 
在 本 节 中 ， 你 将 会 学 到 如 何 使 用 这 三 种 方法 创建 一 个 新 的 仓库 。 
开始 时 ， 创 建 一 个 文件 夹 ， 用 于 存储 你 所 有 的 样 例 仓库 ( 例 5-1)。 你 可 以 选择 将 这 个 文件 
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夹 放 在 你 的 桌面 上 、 你 的 home 目录 中 ， 或 是 其 他 什么 地 方 。Git 不 关心 这 个 文件 夹 的 位 
置 ， 只 要 你 自己 记得 这 个 文件 夹 的 位 置 即 可 。 










在 我 开始 编写 代 





































TATAN 在 工 单 创建 后 ， 我 
码 前 ， 我 需要 做 1234-ticket e UU A 
第 一 什 事 是 创 创建 一 个 分 支 并 开 






















建 一 个 工 单 来 跟 


踪 我 的 工作 。 始 工作 。 












master 








































A 工作 经 过 了 完全 的 

[7] 代码 符合 相关 标准 

运行 相关 测试 集 现在 我 可 以 将 我 
[7] 代码 有 注释 或 文档 编辑 添加 到 暂 存 






回 工作 经 过 了 拼写 检查 










在 我 的 更 改 被 暂 存 
后 ， 我 可 以 将 工作 
提交 到 本 地 仓库 ， 
以 便 共享 。 



























git push 集中 式 代码 


托管 系统 












git commit 





HFRS S, $ 
等 待 相关 人 
员 批准 


Sa 本 地 仓库 Pe 
i 集中 式 代码 


托管 系统 











master 























准备 收尾 ! 合并 到 

master 分 支 ， 部 署 

到 p d 分 支 ， 最 后 
关闭 工 单 。 








生产 环境 


master 




















图 5-1: 勾勒 你 的 工作 流 图 
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18] 5-1 在 home 目录 下 创建 一 个 项 目 目 录 

$ mkdir learning-git-for-teams 

$ cd learning-git-for-teams 
除非 特别 说 明 ， 本 书 所 有 练习 都 会 假设 你 当前 正在 访问 该 文件 夹 中 的 一 个 样 例 仓 库 。 如 果 
需要 使 用 特定 的 仓库 ， 我 将 会 在 说 明 中 指出 。 但 一 般 来 说 ， 使 用 哪个 仓库 并 不 重要 。 


5.2.1 克隆 已 有 的 项 目 

在 代码 托管 系统 (例如 GitLab 或 GitHub) 上 ， 当 你 访问 一 个 项 目 页 面 时 ， 通常 能 够 找到 
一 个 选项 来 将 所 有 文件 下 载 为 .zip 压缩 包 ， 或 者 创建 一 个 仓库 的 克隆 。 这 些 选 项 通常 都 在 
一 起 ， 但 并 非 一 定 在 一 起 。 图 5-2 显示 了 GitLab 中 仓库 URL 的 地 址 。 
































€ © Ç | https;//gitlab.com/gitforteams/gitforteams wo a 0 ^»5e6:uwz 

p" 

W Git for Teams / Git for Teams b 
本 Project - README.md *Star 0 P Fork 47 
e iden SSH HTTPS  gitggitlab.com:gitforteams/gitforteams.git Q public X Download zip ~ B 
9 Commits 
p Network Activity Readme 85 commits 4 branches 0 tags 13.5 MB 
CS Graphs 

X. Pushevents (V Merge events — *& Comments &Team Compare code 
o Issues 0 
E Merge Requests 
E q Ea Git for Teams pushed to branch master at Git for Teams / Git ... 22 days ago Created on Sep 09, 2014 
a Wiki a715c069 Adding workflow diagram for: reset, revert, rebase, checkout. Owned by Git for Teams 


794e44f3 Updating feedback URL on final slide to TrueNorthPHP. 
. and 1 more commits. Compare — eedf5da4...a715c069 


E Git for Teams pushed to branch master at Git for Teams / Git ... 4 months ago 
eedf5da4 OSCON webinar updates. 
7798eb10 Lesson 00: introduction to the learning series 


... and 31 more commits. Compare — c5467205...eedf5da4 
E Git for Teams pushed new branch 1-bad jokes at Git for Tea... 4 months ago 


ES Git for Teams pushed to branch video-lessons at Git for Team... 4 months ago 


911578f9 New table of contents on the PDF summary of lessons 











图 52: 克隆 仓库 使 用 的 URL 


熟 能 生 巧 
如 果 使 用 一 个 已 有 的 仓库 来 学 习 Git， 那 么 你 学 习 命令 时 将 会 更 轻松 ， 不 会 
制造 出 一 大 堆 需 要 解决 的 问题 


为 了 下 载 一 个 项 目的 副本 ， 你 将 会 使 用 clone 命令， 如 例 5-2 显示 。 与 下 载 压缩 包 不 同 ， 
ee 它 还 会 记 住 你 下 载 代码 的 地 
方 ， 将 远程 代码 托管 服务 器 设置 为 跟踪 仓库 。 不 要 担心 ， 会 永久 保持 连接 ， 它 只 是 收 
藏 了 这 个 位 置 ， 以 备 你 以 后 想 要 检查 更 新 ， ， E 














个 项 目 只 需要 克隆 一 次 。 一 旦 项 目下 载 完成 后 ， 你 将 会 使 用 一 系列 不 同 的 命令 来 使 它 保 
持 同步 。 在 第 7 章 中 ， 你 将 会 学 到 clone 命令 的 不 同 使 用 方式 。 在 本 章 中 ， 我 们 只 需要 用 
它 来 抓 取 项 目的 一 份 快照 ， 以 使 你 可 以 在 某 个 起 点 上 开始 工作 。 


例 5-2 创建 “Git 团队 协作 ”仓库 的 一 个 克隆 


$ git clone https://gitlab.com/gitforteams/gitforteams.git 
接 下 来 ， 你 的 命令 行 窗口 中 将 会 出 现下 面 的 输出 。 


Cloning into 'gitforteams'... 

remote: Counting objects: 1040, done. 

remote: Compressing objects: 100% (449/449), done. 

remote: Total 1040 (delta 603), reused 915 (delta 538) 

Receiving objects: 100% (1040/1040), 9.49 MiB | 1.68 MiB/s, done. 
Resolving deltas: 100% (603/603), done. 

Checking connectivity... done. 


WEM! 你 已 经 成 功 克 隆 了 你 的 第 一 个 Git 仓库 。 你 可 以 在 这 个 目录 中 随意 折腾 。 如 果 你 
把 这 个 目录 和 弄 得 面 征 全 非 ， 删 除 文件 夹 并 重新 运行 clone 命令 即 可 。 

现在 ， 在 有 了 这 个 目录 之 后 ， 你 同样 拥有 了 本 书 需要 的 所 有 帮助 资料 。 你 可 以 训 览 这 些 帮 
助 文件 ， 寻 找 隐藏 的 彩蛋 ， 随 意 找 些 什么 东西 开始 看 ， 这 样 在 你 学 到 更 多 高 级 命令 时 不 必 
担心 会 制造 出 奇怪 的 问题 ， 或 是 挫 毁 你 自己 的 工作 。 


5.22 ”将 已 有 的 项 目 迁 移 至 Git 
如 果 我 第 一 次 参与 软件 项 目 ， 我 倾向 于 将 文件 打包 下 载 ， 然 后 在 软件 第 一 次 导入 的 某 个 时 
间 点 开始 做 版 本 管理 。 我 将 会 简明 扼要 地 推进 工作 ， 做 一 个 棘手 的 自我 介绍 ， 讲 述 我 要 怎 
样 保持 开发 者 最 初 想 要 的 样子 。 
为 了 比较 你 正在 运行 的 命令 的 作用 ， 请 再 下 载 “Git 团队 协作 ”仓库 ， 不 过 这 次 是 从 你 刚 
克隆 过 的 那个 仓库 中 下 载 一 个 压缩 包 ， 步 又 如 下 所 示 。 
(1) 访 问 https://gitlab.com/gitforteams/gitforteams。 
D 找到 并 下 载 项 目的 压缩 包 。 
(3) 解压 项 目 ， 放 到 你 为 本 书 准 备 的 项 目 目录 下 。 因 为 你 在 这 个 目录 中 已 经 有 了 一 份 克 隆 的 
文件 副本 ， 所 以 你 应 该 将 这 个 新 建 的 文件 夹 命名 为 gitforteams-zip。 
你 可 以 在 任何 文件 夹 下 使 用 初始 化 命令 init 创建 一 个 Git 仓库 ， 如 例 5-3 所 示 。Git 将 会 感 
知 到 这 个 目录 中 的 所 有 文件 ， 包 括 子 目录 ， 从 而 确保 你 是 在 项 目的 根 目录 下 运行 init 命令 。 
例 5-3 初始 化 目录 的 版 本 控制 
$ git init 
你 将 会 看 到 类 似 以 下 内 容 的 一 条 消息 。 
Initialized empty Git repository in /Users/emmajane/gitforteams/gitforteams-zip/.git/ 
系统 并 没有 立即 将 文件 加 入 仓库 。 这 是 Git 的 一 个 特性 ， 因 为 它 同样 允许 你 忽略 文件 ， 你 
需要 主动 告诉 它 你 想 要 跟踪 哪些 文件 。 如 果 存 在 相关 的 下 一 个 步骤 ，Git 几乎 总 是 会 在 状 
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态 (status) 消息 中 显示 有 用 的 建议 。 你 应 该 养 成 经 常 使 用 status 命令 的 习惯 ， 就 像 在 文 
字 处 理 程序 中 使 用 保存 那么 频繁 。 这 个 命令 不 会 保存 你 的 工作 ， 但 它 让 你 知道 当前 仓库 
中 发 生 了 什么 。 知 道 仓 库 中 发 生 了 什么 是 理解 Git 的 关键 。 快 去 查看 你 的 仓库 的 当前 状态 
( 例 5-4). 
例 5-4 检查 仓库 的 当前 状态 

$ git status 
Git 告诉 你 ， 下 一 步 是 添加 你 想 要 跟踪 的 文件 ， 因 为 你 刚刚 初始 化 了 仓库 ， 如 下 所 示 。 


On branch master 

















Initial commit 


Untracked files: 
(use "git add <file>..." to include in what will be committed) 


[ lots of files listed here ... ] 
nothing added to commit but untracked files present (use "git add" to track) 


将 文件 导入 Git 4: 29V 2, KERREIZ WAER, XX BE few WT TIEB3 
中 同时 进行 多 个 无 关 的 更 改 。 更 改 可 以 被 暂 存 在 索引 (index) 的 一 组 提交 中 ， 每 组 都 有 一 
个 不 同 的 提交 消息 。 我 们 希望 添加 工作 目录 中 的 所 有 文件 ， 因 为 这 是 我 们 第 一 次 导入 文件 
( 例 5-5)。 


例 5-5 将 仓库 中 所 有 文件 添加 至 暂 存 区 


$ git add --all 
同样 ， 可 以 使 用 status 命令 来 检查 当前 状态 。 这 个 命令 的 输出 将 会 提示 你 这 些 文件 已 经 被 
暂 存 并 已 准备 好 提交 ， 如 下 所 示 。 


On branch master 




















Initial commit 


Changes to be committed: 
(use "git rm --cached <file>..." to unstage) 


new file: [ lots of files listed ... ] 
现在 ， 你 的 文件 已 经 添加 完毕 ， 你 可 以 使 用 commit 命令 将 你 当前 的 状态 保存 到 仓库 
( 例 5-6) 。 
例 5-6 将 所 有 和 暂 存 的 文件 提交 至 仓库 


$ git commit -m "Initial import of all project files." 
此 时 会 在 屏幕 上 输出 一 个 较 长 的 提交 确认 信息 ， 提 醒 你 已 经 将 这 些 文件 加 入 你 的 仓库 。 你 
的 项 目 文件 现在 已 经 处 于 版 本 控制 下 。 

















5.2.83 初始 化 空 项 目 

在 我 们 教学 Git 时 ， 从 一 个 什么 都 没有 的 空 目录 开始 是 最 容易 的 ， 因 为 讲师 和 学 生 很 容易 
从 一 个 相同 的 起 点 开始 。 下 面 这 个 练习 能 让 你 轻松 地 初 识 Git, 

(1) 创建 一 个 新 的 空 文件 夹 ， 如 下 所 示 。 


$ mkdir empty-repository 


Q) 进入 新 创建 的 文件 夹 ， 如 下 所 示 。 

$ cd empty-repository 
(3) 运行 Git 初始 化 命令 ， 如 下 所 示 。 

$ git init 
(4) 确认 已 添加 隐藏 的 仓库 文件 夹 ， 如 下 所 示 。 

$ ls -al 

在 Windows 上 的 命令 如 下 所 示 。 

dir 
如 果 你 看 到 了 一 个 新 的 隐藏 文件 夹 .git， 那 么 你 的 仓库 已 经 成 功 创建 。 这 个 文件 夹 将 会 包 
含 你 仓库 中 所 有 更 改 的 记录 。 这 个 文件 夹 里 没有 什么 可 怕 的 东西 ， 但 如 果 你 删除 了 它 ， 那 
么 系统 将 无 法 继续 跟踪 你 的 项 目 。 也 就 是 说 ， 你 将 不 再 能 够 在 你 的 仓库 中 恢复 任何 文件 之 
前 的 版 本 ， 并 将 丢失 仓库 中 所 有 的 提交 消息 ， 而 文件 当前 的 状态 也 将 不 可 变 。 
现在 ， 你 可 以 遵循 上 节 中 的 额外 步 又 来 添加 文件 ( 例 5-5)， 并 将 它们 提交 至 你 的 仓库 
( 例 5-6)。 


524 查看 历史 记录 

一 旦 你 完成 了 仓库 中 的 第 一 个 提交 ， 就 可 以 开始 查看 历史 记录 了 了。 当然 ， 你 的 项 目 历史 是 你 
已 经 完成 的 工作 和 其 他 协作 者 完成 的 工作 的 组 合 。 如 果 你 从 未 下 载 过 开源 项 目 ， 那 么 几乎 感 
受 不 到 协作 的 存在 ， 但 它 确实 存在 。 协 作 可 以 简单 到 只 是 在 别人 的 工作 上 添加 你 的 更 改 。 
要 查看 仓库 中 产生 的 更 改 ， 请 使 用 log 命令 ( 例 5-7)。 上 默认 情况 下 ， 这 个 命令 允许 你 查看 
本 地 仓库 当前 签 出 分 支 中 的 每 个 提交 的 提交 消息 和 作者 信息 。 


例 5-7 使 用 Tog 命令 查看 仓库 历史 记录 
$ git log 


log 命令 将 会 按时 间 倒序 输出 仓库 中 提交 消息 的 完整 历史 记录 。 












































确保 你 的 详细 信息 已 经 进行 配置 
如 果 你 的 名 字 和 邮件 地 址 没有 显示 出 来 ， 参 见 附录 C 来 了 解 如 何 配 置 Git。 
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如 果 你 只 产生 了 一 条 提交 消息 ， 也 就 是 最 初 的 一 次 导入 ， 那 么 只 有 一 条 消息 会 被 显示 出 
来 ， 如 下 所 示 。 
commit fa04c309e3bb8de33f77c54c1f6cc46dc520c2ca 


Author: emmajane <emmaQemmajane.net> 
Date: Sat Oct 25 12:44:39 2014 +0100 


Initial import of all project files. 


但 如 果 你 在 一 个 更 完善 的 代码 库 上 工作 ， 那 么 代码 库 里 面 将 会 有 很 多 消息 。 看 完 这 些 消息 
所 需 的 工作 量 将 会 是 巨大 且 复杂 的 。 你 可 以 通过 添加 --oneline 参数 来 缩短 消息 ， 只 显示 
消息 的 第 一 行 ， 如 例 5-8 所 示 。 按 q 退出 。 


例 5-8 查看 缩短 的 项 目 历史 记录 


$ git log --oneline 


为 了 理解 同一 个 文件 如 何 拥 有 不 同 的 历史 记录 ， 在 克隆 的 仓库 和 通过 下 载 的 zip 包 创建 的 
仓库 中 ， 分 别 运行 例 5-7 和 例 5-8 中 的 命令 。 即 使 这 些 文件 是 相同 的 ， 它 们 的 历史 记录 也 
并 不 相同 (在 第 6 章 讲 到 变 基 时 会 再 次 提 到 )。 


其 他 分 支 会 有 不 同 的 提交 ， 而 且 不 同 的 仓库 副本 中 会 包含 不 同 开发 者 产生 的 
提交 。 事 实 上 这 很 混乱 ， 但 混乱 仅 存 在 于 每 个 仓库 内 。 作 为 软件 团队 ， 我 们 
创建 的 约定 可 帮助 我 们 在 混乱 中 重建 秩序 ， 并 允许 我 们 以 相同 的 行为 共享 工 
作 。( 记 得 第 3 章 中 提 到 的 分 支 策略 吗 ? 它们 将 会 保持 工作 按照 符合 逻辑 的 
线性 排序 。 记 得 第 2 章 中 的 权限 策略 吗 ? 它们 将 会 把 人 们 锁定 在 正确 的 位 置 
上 ， 并 且 无 法 在 没有 社区 看 门人 同意 的 情况 下 对 “幸运 ”仓库 进行 更 改 。) 



































如 有 果 你 完成 了 本 节 中 的 所 有 步骤 ， 现 在 就 会 有 三 个 独立 的 仓库 来 完成 剩余 的 活动 。 对 于 有 
关 分 支 的 部 分 ， 我 建议 你 使 用 克隆 的 仓库 ， 因 为 它 有 更 多 分 支 可 供 你 查看 。 对 于 其 他 部 
分 ， 你 可 以 选择 三 者 中 的 任意 一 种 。 


5.3 使 用 分 支 工 作 


在 版 本 控制 中 ， 分支 是 分 离 不 同 想法 的 方式 。 分 支 有 很 多 种 用 法 。 你 可 以 使 用 分 支 来 标记 
软件 的 不 同 版 本 。 你 可 能 会 使 用 临时 的 分 支 来 解决 一 个 bug， 或 者 使 用 长 期 运行 的 分 支 来 
测试 一 个 新 的 想法 。 


5.3.4 列 出 分 支 


要 列 出 所 有 分 支 〈 例 5-9) ， 你 可 以 使 用 不 加 参数 的 branch 命令 ,或 者 添加 - -List 参数 。 
在 本 章 开 始 时 ， 你 克隆 过 一 个 仓库 ， 在 本 节 中 将 使 用 这 个 仓库 ， 因 为 它 已 经 包含 了 你 需要 
查看 的 分 支 。 


例 5-9 列 出 本 地 分 支 


$ git branch --list 
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本 地 分 支 将 以 列表 的 形式 输出 ， 如 下 所 示 。 

master 
在 默认 情况 下 ， 会 将 master 分 支 复制 到 你 的 本 地 仓库 中 ， 然 后 你 可 以 直接 在 这 个 分 支 上 工 
作 。 除 了 这 个 分 支 以 外 ， 你 还 下 载 了 远程 仓库 中 所 有 其 他 的 已 有 分 支 。 你 可 以 引用 这 些 分 
支 ， 但 在 设置 好 远程 分 支 的 工作 副本 之 前 ， 将 无 法 在 这 些 分 支 上 工作 。 要 列 出 仓库 中 的 所 
EDX, WEH --all 参数 (l 5-10)。 
例 5-10 列 出 所 有 分 支 

$ git branch --all 
如 果 你 在 克隆 仓库 的 本 地 副本 中 执行 这 个 命令 ， 应 该 会 同时 看 到 你 的 本 地 分 支 和 一 个 远 
程 分 支 。* 表示 你 当前 正在 查看 (或 “ 签 出 ”) 的 分 支 。 剩 下 几 行 以 remotes/origin 开头 : 
remotes 仅 表示 “不 在 本 地 ”， 而 origin 是 一 种 默认 约定 ， 表 示 “ 我 的 副本 是 从 这 克隆 的 ”。 
最 后 一 部 分 是 分 支 名 (master, sandbox 和 video-lessons 就 是 所 有 的 分 支 了 ) ， 如 下 所 示 。 


* master 
remotes/origin/master 
remotes/origin/sandbox 
remotes/origin/video-lessons 


不 过 ， 这 个 列表 可 能 会 有 些 误导 。 事 实 上 ， 远 程 分 支 的 名 称 中 不 包含 remotes 这 个 
词 。 它 只 是 用 来 告诉 你 它 所 对 应 的 分 支 类 型 。 要 获得 可 用 的 远程 分 支 名 的 列表 ， 请 使 用 
--remotes 参数 〈 或 缩 略 为 -r， 例 5-11). 


例 5-11 列 出 远程 分 支 
$ git branch --remotes 

这 个 命令 将 会 给 你 一 个 仅 包含 远程 分 支 的 列表 (使 用 这 些 分 支 的 真实 名 称 )， 如 下 所 示 。 
origin/master 
origin/sandbox 


origin/video-lessons 


你 可 以 访问 到 这 些 分 支 ， 尽管 你 需要 在 向 它们 提交 更 改 之 前 创建 你 自己 的 副本 。 


5.3.2 更 新 远程 分 支 列 表 


远程 分 支 列表 不 会 自动 更 新 ， 因 此 这 个 列表 将 会 随 着 时 间 而 落后 。 使 用 fetch 命令 更 新 这 
个 列表 〈 例 5-12). 


例 5-12 ”获取 更 新 的 列表 和 所 有 远程 分 支 的 内 容 


$ git fetch 


你 将 在 第 7 章 中 学 到 更 多 与 远程 工作 相关 的 内 容 。 


5.3.3 ”使 用 不 同 的 分 支 


当 你 签 出 一 个 分 支 时 ， 你 更 新 了 系统 (工作 区 ) 中 的 可 见 文件 ， 来 匹配 仓库 中 存储 的 版 
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本 。 这 个 切换 是 通过 checkout 命令 完成 的 〈 例 5-13)。 签 出 过 程 与 SVN 等 集中 式 版 本 管理 
系统 (VCS) 有 些 不 同 。 在 集中 式 VCS 中 ， 由 于 分 支 并 没有 存储 在 本 地 ， 你 需要 网 络 连接 
才能 使 用 checkout 命令 ， 而 且 必 须 在 使 用 之 前 下 载 这 些 分 支 。 

例 5-13 使 用 checkout 命令 切换 分 支 


$ git checkout --track origin/video-lessons 








Branch video-lessons set up to track remote branch video-lessons from origin. 
Switched to a new branch 'video-lessons' 


在 旧版 本 的 Git 中 ， 这 个 命令 的 工作 方式 有 些 不 同 。 如 果 前 置 命令 报错 ， 你 可 能 会 选择 升 
级 (参见 附录 B)， 或 运行 下 面 的 变种 命令 。 

$ git checkout --track -b video-lessons origin/video-lessons 
这 个 命令 (checkout -b) 启用 了 跟踪 〈--track)， 从 远程 仓库 origin 中 存储 的 video- 
lessons 分 支 上 ， 创 建 了 一 个 名 为 video-lessons 的 新 分 支 。 这 个 远程 分 支 的 本 地 副本 可 以 
通过 origin/video-lessons 访问 到 ， 而 你 自己 的 分 支 副本 可 以 通过 video-lessons 访问 到 。 
你 现在 应 该 已 经 有 了 远程 分 支 video-lesson 的 一 份 本 地 副本 (图 5-3). 
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图 5-3. 远程 分 支 的 本 地 副本 已 经 创建 


在 你 的 分 支 列表 中 ， 似 乎 这 个 分 支出 现 了 两 次 ， 这 是 因为 其 中 一 次 代表 远程 仓库 中 的 引用 
信息 ， 如 下 所 示 。 


$ git branch -a 








master 

* video-lessons 
remotes/origin/master 
remotes/origin/sandbox 
remotes/origin/video-lessons 


从 新 的 分 支 上 ， 你 可 以 使 用 例 5-22 或 例 5-23 来 查看 历史 记录 。 注 意 ， 两 个 分 支 中 的 提交 
历史 是 不 一 样 的 。 


5.3.4 创建 新 的 分 支 


对 于 小 型 项 目 来 说 ， 我 愉快 地 将 master 分支 中 的 每 个 提交 都 视 为 一 个 问题 解决 方案 。 但 
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是 ， 当 团队 规模 增长 时 ， 确 立 团队 结构 的 协作 方式 将 会 使 你 越 来 越 多 地 受益 。 第 3 章 讲 到 
了 你 可 能 想 在 你 的 团队 中 采用 的 分 支 策略 。 作 为 独立 开发 者 ， 你 或 许 更 难 明 白 什 么 时 候 你 
应 该 在 一 个 不 同 的 分 支 上 工作 。 为 了 帮助 你 作出 决定 ， 请 问 自己 以 下 儿 个 问题 。 

。 如 果 进 行 得 不 顺利 ， 我 是 否 会 想 要 完全 丢弃 这 个 想法 ? 

。 我 正在 创造 的 东西 是 否 严重 偏离 了 当前 发 布 的 软件 版 本 ? 

。 在 进行 发 布 或 被 软件 的 发 布 版 本 接受 之 前 ， 我 的 工作 是 否 需 要 经 过 评审 ? 
。 完成 这 项 工作 之 前 ， 我 是 否 有 可 能 切换 到 其 他 任务 上 去 ? 
如 果 你 对 每 个 问题 都 持 有 肯定 的 答复 ， 你 应 该 考虑 为 你 的 工作 创建 一 个 新 的 分 支 。 现 在 开始 
培养 良好 的 使 用 习惯 就 像 是 买 保险 一 样 ， 你 希望 你 永远 都 不 会 用 上 ， 但 总 得 提前 做 好 准备 。 
决定 什么 工作 需要 进入 新 的 分 支 的 最 佳 方式 是 使 用 issue 跟踪 工具 。 通 过 书面 描述 你 即将 
进行 的 工作 ， 你 将 会 对 什么 时 候 开 始 并 结束 你 的 分 支 看 得 一 清二 楚 。 是 的 ， 这 通常 看 上 去 
很 系 琐 ， 但 这 是 一 个 值得 养 成 的 习惯 ， 尤 其 是 当 你 在 更 大 的 团队 中 工作 时 。 

当 你 创建 了 一 个 新 的 分 文 ， 此 时 这 个 分 支 包 含 了 与 原 分 支 相同 的 历史 记录 (图 5-4) 。 当 你 
使 用 log 命令 查看 新 的 分 支 的 历史 记录 时 ， 祖 先 分 支 中 的 提交 也 会 显示 出 来 。 






















































































父 分 支 或 祖先 分 支 新 分 支 


^ 











图 5-4. 新 的 分 支 包 含 祖先 分 支 中 的 相同 提交 


假设 你 在 使 用 基于 issue 的 版 本 控制 ， 你 的 分 支 名 应 该 能 够 反映 你 正在 工作 的 工 单 。 例 如 ， 
如 果 issue 是 “1: Add process notes to README”( 在 README 中 添加 过 程 备 忘 )， 那 么 分 
支 应 该 被 命名 为 1-process_notes。 新 分 支 的 历史 将 会 包括 当前 所 有 提交 ， 因 此 确保 你 从 正 
确 的 起 点 开始 新 的 分 支 。 你 可 以 通过 checkout 命令 来 移动 到 正确 的 分 支 ( 例 5-14) ， 或 者 
你 可 以 将 你 想 要 的 父 分 支 添加 到 你 的 命令 中 (A 5-15). 
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例 5-14 创建 一 个 新 的 开发 分 支 
首先 签 出 你 希望 作为 起 点 使 用 的 分 支 ， 如 下 所 示 。 


$ git checkout master 








Switched to branch 'master' 


然后 ， 创 建 一 个 新 的 分 支 ， 如 下 所 示 。 


$ git branch 1-process notes 


[没有 消息 显示 ] 
最 后 ， 签 出 新 分 支 ， 如 下 所 示 。 


$ git checkout 1-process notes 























Switched to branch '1-process notes' 


尽管 要 记 的 东西 有 点 多 ， 但 例 5-15 的 优点 是 可 以 直接 从 正确 的 基线 分 支 创 建 一 个 新 的 分 
支 ， 这 意味 着 你 不 需要 记 住 之 前 的 指令 来 执行 额外 的 签 出 步骤 。 


例 5-15 ”从 主 分 支 创建 一 个 新 的 开发 分 支 


$ git checkout -b 1-process notes master 











Switched to a new branch '1-process notes' 


一 旦 你 签 出 到 新 的 分 支 ， 就 可 以 继续 完成 你 的 工作 。 作 为 一 个 小 练习 ， 我 鼓励 你 试 着 写 下 
一 些 笔记 ， 记 录 你 在 本 章 创建 的 三 个 仓库 的 一 个 仓库 中 采用 了 怎样 的 流程 。 在 你 的 修改 全 
部 结束 后 ， 是 时 候 将 你 的 更 改 提 交 至 本 地 仓库 了 。 


5.4 在 仓库 中 添加 更 改 


每 次 你 在 工作 目录 中 进行 修改 时 ， 都 需要 显 式 地 将 这 些 更 改 保存 到 你 的 Git 仓库 。 这 个 过 
程 分 为 两 步 。 图 5-5 显示 应 该 如 何 将 更 改 显 式 地 暂 存 到 索引 ， 然 后 保存 至 你 的 仓库 。 
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图 5-5: Git 中 的 更 改 必须 先进 行 暂 存 ， 然 后 再 保存 至 仓库 


之 前 你 创建 一 个 新 的 仓库 时 ， 一 次 性 导入 了 一 系列 文件 ( 例 5-5) 。 不 过 ， 你 也 可 以 选择 不 
这 么 做 。 当 你 同时 进行 一 些 不 相关 的 编辑 ， 并 且 想 将 这 些 修 改 放置 在 不 同 的 提交 中 时 ， 这 
个 功能 将 会 尤为 有 用 。 如 果 你 确实 希望 将 这 些 更 改 分 离 到 多 个 提交 ， 需 要 将 先前 使 用 的 
--all 参数 替换 成 你 想 要 暂 存 的 文件 名 (08 5-16)。 你 可 以 同时 添加 一 个 或 多 个 文件 名 , XX 
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件 名 不 需要 是 同一 种 类 型 的 。 
例 5-16 将 选中 的 已 更 改 文件 添加 至 你 的 Git 仓库 


$ git add README.md process-diagram.png 


$ git add branch-naming-rules.png 


大 多 数 时 候 ， 我 都 会 一 次 一 个 地 将 文件 添加 到 和 暂 存 区 。 我 发 现 这 个 习惯 能 够 避免 我 意外 添 
加 更 多 文件 。 在 命令 行 中 ， 我 可 以 输入 文件 名 的 前 几 个 字母 ， 按 下 Tab 键 ， 然 后 剩 下 的 
文件 名 会 自动 显示 出 来 (这 就 是 Tab 补 会 ， 我 的 最 爱 之 一 )。 但 是 ， 如 果 你 有 很 多 文件 需 
要 添加 ， 而 且 它 们 还 不 在 同一 个 目录 下 ， 你 或 许 会 想 要 使 用 通配符 来 匹配 子 目 录 中 的 文件 
(685-17) , 或 者 匹配 文件 名 相似 的 文件 (B 5-18)。 


例 5-17 递归 地 添加 指定 路 径 中 的 所 有 文件 


$ git add «directory name»/* 


例 5-18 添加 扩展 名 为 .svg 的 所 有 文件 


$ git add *.svg 


你 还 可 以 完全 忽略 文件 名 ， 根 据 Git 中 是 否 已 知 这 些 文件 来 暂 存 它们 。 通 过 使 用 --update 
参数 ， 你 可 以 暂 存 Git 中 所 有 已 知 的 且 在 上 次 提交 之 后 编辑 过 〈 或 修改 过 ) 的 文件 ， 如 下 
所 示 。 


$ git add --update 


如 果 你 想 要 更 加 粗放 一 些 ， 可 以 添加 --all 参数 来 暂 存 工作 目录 中 所 有 修改 过 的 文件 。 这 
个 参数 将 会 重新 暂 存 在 首次 暂 存 后 发 生 修改 的 任何 文件 (确保 所 有 新 的 修改 都 包含 在 这 个 
提交 中 。 暂 存 Git 中 所 有 已 知 但 还 没有 进行 暂 存 的 文件 ， 暂 存 任何 当前 未 被 Git 跟踪 的 文 
件 。 这 是 一 个 非常 贫 禁 的 命令 ! 在 使 用 前 ， 你 应 该 检查 即将 添加 的 文件 的 列表 ， 如 下 所 示 。 


$ git status 
$ git add --all 


一 旦 将 变更 添加 至 暂 存 区 ， 就 必须 提交 这 个 更 改 。 如 果 你 继续 编辑 任何 一 个 刚刚 添加 到 索 
引 中 的 文件 ， 那 么 在 下 次 运行 comit 命令 时 ， 仅 会 添加 之 前 暂 存 过 的 更 改 (图 5-6)。 如 
果 你 继续 修改 某 个 文件 ， 并 且 希 望 新 的 变更 包含 在 提交 中 ， 就 需要 重复 之 前 的 命令 ， 再 次 
将 文件 添加 至 暂 存 区 。 


你 可 以 运行 comit 命令 来 将 暂 存 的 变更 提交 至 仓库 (Di 5-6)。 


如 果 你 在 最 初 感到 有 些 挫 败 ， 请 记 住 不 是 只 有 你 一 个 人 是 这 样 的 ! 我 花 了 很 长 时 间 来 习惯 
它 的 行为 ， 当 它 没 有 意识 到 我 已 经 修改 了 文件 并 暂 存 了 新 的 修改 时 ， 我 还 以 为 是 Git 坏 了 。 
直到 开始 学 到 部 分 暂 存 文件 ， 我 才 意 识 到 “不 自动 暂 存 我 的 修改 ”这 个 功能 有 多 么 强大 。 
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git add --all 
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更 多 编辑 


更 改 未 暂 存 











更 改 未 暂 存 











图 5-6: 一 次 提交 只 会 保存 已 添加 至 索引 中 的 文件 


5.4.1. 在 仓库 中 添加 部 分 文件 修改 


如 果 你 希望 你 的 提交 能 有 更 细 的 粒度 ， 那 么 可 以 选择 使 用 - -patch 参数 来 添加 已 保存 的 文 
件 中 的 部 分 修改 。 我 喜欢 使 用 这 种 方式 提交 文件 ， 其 中 一 个 原因 是 ， 我 可 以 将 无 关 的 编辑 
记录 在 多 个 更 小 的 提交 中 。 


通过 - -patch 添加 文件 的 过 程 分 成 多 个 步骤 〈 例 5-19)。 你 将 首先 初始 化 这 个 过 程 ， 然 后 
从 列表 中 选 出 一 个 选项 ， 来 决定 如 何 创 建 你 的 补丁 。 你 将 会 看 到 一 条 提示 ， 将 这 些 修改 添 
加 至 暂 存 区 (y)， 或 不 改变 这 个 补丁 片段 (hunk) (n)。 修 改过 的 行将 会 以 一 个 -删除 的 
fr) 或 一 个 + (新 增 的 行 ) 开头 。 如 果 某 行进 行 过 修改 ， 它 会 同时 显示 为 被 王 除 和 被 新 增 。 
为 了 将 这 些 补丁 片段 拆 分 成 更 小 的 单元 ， 你 可 以 使 用 s 选项 来 拆 分 这 个 补丁 片段 。 只 有 在 
两 个 补丁 片段 之 间 存在 至 少 一 行 未 修改 的 工作 时 ， 这 个 选项 才 会 生效 。 如 果 你 希望 将 相 邻 
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的 两 


例 5-19 将 选中 的 修改 交互 式 地 添加 到 你 的 Git 仓库 


了 分 别 暂 存 ， 可 以 编辑 (e) 这 个 补丁 片段 。 








$ git add --patch filename 


HUBURAS 


文件 ， 





堆 加 可 选 的 文件 名 ， 你 不 再 需要 将 所 有 文件 都 看 一 遍 。 如 果 你 确切 知道 想 要 分 居 
并 且 有 很 多 文件 需 ETE, 这 个 选项 可 以 节省 你 大 量 处 理 单个 文件 的 时 间 。 在 运 


c 








哪些 
efr 




















这 个 命令 后 ， 你 将 会 开始 遍历 这 些 文件 ， 寻 找 需要 和 暂 存 的 修改 ， 如 下 所 示 。 


diff --git a/ch05.asciidoc b/ch05.asciidoc 

index 8f82732..e7be9ce 100644 

--- a/ch05.asciidoc 

+++ b/ch05.asciidoc 

@@ -6,7 +6,6 @@ changed significantly in the last few years; however, a few of 
the commands we'l easier to remember. Chances are very good that you have Git 
installed if you are using Linux or OSX. If you are using Windows, however, 
the changes are very good that Git is not installed unless you've explicitly 
installed it already. 


. Open a terminal window. 
. Enter the command: «git --version-* 


The version of Git you are running should be printed to the screen. 


Stage this hunk [y,n,q,a,d,/,j,2,9,e,?]? 








在 这 里 显示 的 输出 中 ， 我 们 可 以 看 到 Git 询问 我 们 是 否 想 要 和 暂 存 这 一 行 修改 (. Open a 














terminal window.)， 也 就 是 通过 - 指示 的 这 一 行 删除 。 你 可 以 按 下 ? 查看 处 理 这 个 补丁 片 








段 的 其 他 选项 。 
5.4.2. ”提交 部 分 更 改 


假设 你 办 


刚才 只 将 某 个 文件 中 的 部 分 修改 添加 到 了 和 暂 存 区 ， 那 么 在 查看 仓库 状态 的 时 候 ， 将 








会 看 到 这 个 文件 准备 好 了 被 提交 的 修改 ， 同 时 也 包含 未 被 暂 存 的 修改 ， 如 下 所 示 。 


On branch master 
Changes to be committed: 





(use "git reset HEAD <file>..." to unstage) 


modified: ch05.asciidoc 


Changes not staged for commit: 


(use "git add <file>..." to update what will be committed) 
(use "git checkout -- <file>..." to discard changes in working directory) 


modified: ch05.asciidoc 


如 有 果 你 将 一 个 文件 添加 至 暂 存 区 ， 然 后 在 提交 至 仓库 之 前 继续 编辑 这 份 文 件 ， 或 者 如 果 你 
只 选择 暂 存 一 些 补丁 片段 ， 同 时 使 用 patch 参数 交互 地 将 文件 添加 到 索引 ， 都 会 出 现 与 此 
相同 的 信息 。 
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5.4.3 ”从 暂 存 区 移 除 文件 


如 有 果 你 不 小 心 向 暂 存 区 添加 了 太 多 的 文件 ， 同 时 想 把 这 些 修 改 分 割 为 更 小 的 提交 ， 那 么 可 
以 取消 暂 存 你 提出 的 修改 ( 例 5-20)。 从 暂 存 区 移 除 文件 并 不 意味 着 撤销 你 所 做 的 修改 ; 
它 会 通知 Git， 你 现在 还 设 有 准备 好 将 这 些 更 改 提交 到 仓库 。 


例 5-20 从 暂 存 区 移 除 提 出 的 文件 修改 
$ git status 
On branch master 
Changes to be committed: 
(use "git reset HEAD <file>..." to unstage) 











modified: ch05.asciidoc 


$ git reset HEAD ch05.asciidoc 
Unstaged changes after reset: 
M ch05.asciidoc 


另外 ， 如 果 你 只 想 取消 暂 存 你 对 文件 做 出 的 某 些 修改 ， 那 么 还 可 以 使 用 reset 命令 和 
--patch 参数 。 


撤销 工作 将 会 在 第 6 章 中 更 详细 地 介绍 。 


5.4.4. 编写 扩展 提交 消息 

到 现在 为 止 ， 你 可 能 都 在 编写 精简 的 单行 提交 消息 。 如 果 你 只 是 在 练习 版 本 控制 命令 ， 
么 做 没有 关系 ， 但 如 果 你 以 后 需要 和 弄 清楚 一 条 叫 “ 糟 糕 ， 再 试 一 次 ”的 提交 消息 是 什么 
E, PATATAREN. 

我 曾经 将 Git 当成 一 个 保存 工作 而 不 是 记录 结果 的 地 方 ， 我 伦 了 好 长 一 段 时 间 来 摆脱 这 
种 思维 方式 。 当 我 第 一 次 开始 使 用 版 本 控制 时 ， 为 了 利用 这 套 先进 的 工具 ， 我 创建 的 提 
交 粒 度 非常 细 〈 详 见 第 6 章 )。 这 是 因为 我 脑 中 想 的 是 保存 工作 并 撤销 错误 。 用 保存 的 想 
法 思考 时 ， 我 会 想到 点 击 保存 按钮 ， 或 者 使 用 Control-Z 来 撤销 我 刚 输入 的 一 些 东 西 。 当 
提交 变 得 如 此 细小 时 ， 提 交 消 息 就 没有 什么 意义 了 【〔“ 去 吃 午饭 了 ”“ 试 了 一 下 ”“ 还 是 不 
行 ”“ 粳 糕 ”“ 测 试 )。 如 果 我 想 要 回 德 历史 ， 那 么 要 如 何 用 这 些 提 交 信 息 来 找到 出 错 前 正 
常 工作 的 代码 ? 找到 自己 的 节奏 也 需要 花费 不 少时 间 。 

你 的 提交 消息 应 该 总 是 包含 做 出 这 个 修改 的 原因 ， 以 及 对 你 做 出 的 修改 的 一 个 简要 总 结 。 
为 了 编写 一 条 详细 的 提交 消息 ， 对 于 你 一 直 使 用 至 今 的 单行 短 消息 样式 ， 你 需要 编写 多 行 
这 样 的 消息 。 我 通常 使 用 下 面 的 两 步 过 程 来 编写 我 的 提交 消息 〈 例 5-21)。 

。 使 用 一 个 简短 的 单行 消息 将 修改 提交 至 仓库 。 

。 修补 这 个 提交 ， 完 整地 说 明 我 在 做 出 这 个 修改 时 在 想 什么 。 


例 5-21 编写 详细 的 提交 消息 
$ git add --all 
$ git commit -m "CH05: Adding technical edits." 
$ git commit --amend 
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你 不 需要 分 成 两 步 完 成 ， 你 可 以 在 第 一 次 提交 时 忽略 -mge ARDER P E DR as, 
如 下 所 示 。 

$ git commit 
此 时 你 的 默认 编辑 器 会 打开 ， 然 后 会 提示 你 添加 一 条 新 的 提交 消息 。 这 条 消息 的 第 一 行将 
用 于 显示 --oneline， 所 有 以 # 开 头 的 行将 在 最 终 的 消息 中 进行 注释 。 一 旦 你 编辑 好 你 的 
提交 消息 ， 就 需要 保存 它 ， 然 后 退出 编辑 器 以 完成 提交 。 














使 用 默认 编辑 器 Vim 

默认 情况 下 ， 你 编写 提交 消息 的 编辑 器 是 Vim。 因 为 我 喜欢 Vim， 所 以 接受 了 这 个 默 
认 编 辑 器 。 如 果 你 不 喜欢 Vim， 可 以 参照 附录 C 中 的 信息 来 更 换 编 辑 器 。 你 需要 掌握 
以 下 键盘 命令 来 帮助 你 使 用 Vim, 
。 1 让 你 从 视图 模式 切换 到 插入 模式 。 如 果 你 需要 开始 输入 提交 消息 ， 那 么 将 需要 这 

个 命令 。 
。 esc 返 回 可 视 化 模式 。 随 后 你 可 以 使 用 箭头 键 移动 到 另 一 行 。 
。 :Ww 将 文件 写 回 磁盘 并 保存 。 
。 :q 退 出 编辑 器 ， 回 到 命令 行 。 
你 还 可 以 链 式 使 用 这 些 命令 。 例 如 ， 在 编写 完 你 的 提交 消息 后 ， 你 可 以 使 用 esc :wq 保 
存 并 退出 编辑 器 。 











在 第 6 章 中 你 将 会 学 到 如 何 通过 交互 式 变 基 将 细 粒 度 的 提交 压缩 成 一 个 完整 的 想法 。 


5.4.5 忽略 文件 

最 终 ， 你 可 能 会 遇 到 这 样 的 情况 ，Git 不 断 将 你 想 添 加 的 文件 加 入 到 仓库 。 如 果 你 使 用 
Mac， 这 可 能 是 烦人 的 .DS_Store 文件 。 如 果 你 使 用 Linux， 这 可 能 是 文本 编辑 器 的 .swp 
文件 。 如 果 你 在 进行 一 个 Web 项 目 ， 它 可 能 会 包含 从 Sass 编译 出 的 CSS 文件 。 

如 果 你 知道 你 最 喜爱 的 文本 编辑 器 或 IDE 会 制造 临时 文件 ， 且 这 些 文件 与 项 目 无 关 ， 那 么 
你 应 该 创建 一 个 全 局 设置 来 忽略 这 些 文件 。 

首先 ， 运行 下 面 的 命令 来 告诉 Git“ 忽 略 ”文件 的 列表 存放 在 什么 位 置 。 


$ git config --global core.excludesfile -/.gitignore 


你 现在 可 以 更 新 这 个 文件 ， 每 行 一 个 文件 名 。 你 可 以 使 用 确切 的 文件 名 ， 或 者 通配符 
(例如 : *.swp 将 会 匹配 所 有 以 swp 结尾 的 文件 )。 你 可 以 查看 gitignore.io (https://www. 
gitignore.io/) ， 使 用 它 提 供 的 忽略 文件 列表 作为 有 用 的 起 点 。 

另外 ， 你 或 许 希 望 特定 仓库 忽略 特定 的 文件 或 文件 扩展 名 。 在 这 种 情况 下 ， 你 的 最 佳 选择 
是 在 仓库 中 添加 一 个 额外 的 .gitignore 文件 。 这 样 做 附带 的 好 处 是 ， 你 的 队友 一 定 不 会 意外 
地 将 构建 文件 提交 上 来 。 
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完成 下 面 几 步 来 自 定 义 特定 仓库 中 应 该 被 忽略 的 文件 。 

() 在 项 目 根 目录 创建 一 个 名 为 .gitignore 的 文件 。 

(2) 每 行 一 个 文件 名 ， 写 上 所 有 你 一 定 不 希望 Git 添加 到 仓库 中 的 文件 。 你 可 以 使 用 确切 的 
文件 名 或 通配符 (如 *.swp)。 

(3) 使 用 add 和 commit 命令 将 .gitignore 文件 添加 到 你 的 仓库 。 


包含 以 上 扩展 名 的 文件 将 永远 不 会 被 添加 至 你 的 仓库 ， 即 使 你 使 用 了 --all 参数 。 


5.5 ”使 用 标签 


标签 用 于 定位 指定 的 提交 。 你 可 以 将 标签 视 为 书签 。 很 多 时 候 我 应 该 使 用 标签 ， 却 都 没有 
使 用 。 因 此 ， 我 依赖 我 的 提交 消息 来 寻找 仓库 中 的 特定 亨 点 。 你 或 许 会 发 现 使 用 标签 是 一 
个 好 习惯 ， 因 为 它 能 帮助 你 轻松 地 找到 时 间 线 上 的 节点 。 


多 人 团队 中 的 标签 
在 本 章 中 ， 我 们 提 到 的 都 是 私有 仓库 ， 其 中 没有 与 其 他 队友 共享 的 分 支 。 当 
你 的 分 支 没有 进行 共享 时 ， 设 有 理由 限制 你 应 该 如 何以 及 何 时 使 用 标签 。 想 
打 标 签 时 就 打 吧 ! 然而 ， 共 享 分 支 上 的 标签 通常 用 于 开发 目的 ， 且 应 该 遵循 
对 团队 有 利 的 约定 。 















































标签 只 能 被 添加 到 指定 提交 。 为 了 明确 你 想 要 打上 标签 的 提交 ， 你 或 许 会 想 要 同时 使 用 
log 和 show 两 个 命令 。log 命令 将 会 给 你 仓库 中 所 有 提交 的 列表 〈 例 5-22), mi shon 命令 
将 会 显示 每 个 提交 的 详细 信息 。 
例 5-22 最 近 提 交 的 快速 列表 


$ git log --oneline 

fa04c30 Initial import 
一 且 你 觉得 自己 找到 了 你 想 继续 研究 的 提交 ， 就 可 以 通过 添加 提交 ID 来 获得 这 个 提交 
开头 的 详细 提交 消息 〈 例 5-23)。 要 将 输出 限制 到 仅 这 个 提交 ， 请 添加 一 个 可 选 的 参数 
--max-depth=， 后 面 跟着 你 想 要 显示 的 记录 条 数 。 


例 5-23 单个 提交 的 日 志 详 细 信 息 
$ git log fa04c30 --max-depth=1 





commit fa04c309e3bb8de33f77c54c1f6cc46dc520c2ca 
Author: emmajane «emma(emmajane.net» 
Date: Sat Oct 25 12:44:39 2014 +0100 


Initial import 


如 果 你 想 要 了 解 这 个 提交 对 象 的 更 多 信息 ， 可 以 使 用 show 命令 以 文本 形式 列 出 该 提交 中 发 
生 的 修改 (当然 ， 如 果 这 是 二 进 制 文件 ， 例 如 图 片 ， 那 就 没有 什么 用 了 )。 





例 5-24 使 用 show 命令 显示 单个 提交 的 日 志 消 息 和 文本 diff 
$ git show fa04c30 
commit fa04c309e3bb8de33f77c54c1f6cc46dc520c2ca 


Author: emmajane «emma(Qemmajane.net» 
Date: Sat Oct 25 12:44:39 2014 +0100 


Initial import 


diff --git a/ch05.asciidoc b/ch05.asciidoc 
new file mode 100644 
index 0000000..8f82732 
- /dev/null 
+++ b/ch05.asciidoc 
QQ -0,0 «41,867 @@ 
4 
42-22 Verifying Git 
4 
*Before we dive into using Git, you'll want to check and see which version is 
installed. For our purposes, Gi 


[etc] 


一 旦 你 找到 了 想 要 收藏 的 提交 ， 就 可 以 通过 tag 命令 来 完成 这 个 操作 。 在 例 5-25 中 ， 为 提 
交 散 列 faeacae 创建 了 一 个 新 的 标签 import, 


例 5-25 为 某 个 提交 对 象 添 加 一 个 新 的 标签 import 
$ git tag import fa04c30 


你 现在 可 以 使 用 不 加 任何 参数 的 tag 命令 列 出 所 有 已 有 的 标签 ( 例 5-26), 
例 5-26 列 出 所 有 标签 


$ git tag 


屏幕 上 将 会 输出 一 列 标签 。 到 目前 为 止 ， 我们 只 添加 了 一 个 标签 ， 所 以 这 个 列表 非常 简 
短 ， 如 下 所 示 。 


import 


一 旦 标签 被 创建 ， 你 就 可 以 通过 标签 所 在 的 位 置 查看 这 个 提交 ( 例 5-27)。 
例 5-27 查看 带 标签 的 提交 


$ git show import 


正如 你 之 前 所 见 ，show 命令 将 会 显示 该 提交 的 日 志 消 息 和 文本 diff。 


5.6 连接 远程 仓库 


在 Subversion 这 样 的 集中 式 版 本 控制 系统 中 ， 只 有 一 份 仓库 的 主 副本 ， 所 有 工作 都 被 写 入 
那 份 副本 。 当 你 提交 时 ， 信 息 立 即 被 上 传 至 中 央 人 仓库， 并 且 对 其 他 人 可 见 。 在 Git 这 样 的 
去 集中 式 版 本 控制 系统 中 ， 没 有 每 个 人 共同 使 用 的 单一 仓库 。 我 们 通常 会 约定 其 中 一 个 仓 
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库 副本 享有 特权 (并 被 视 为 代码 的 官方 来 源 )。 

当 你 一 个 人 工作 时 ， 远 程 仓库 更 多 是 作为 你 本 地 仓库 的 备份 ， 因 为 除非 你 将 修改 放 到 远程 
仓库 ， 否 则 什么 都 不 会 发 生 。 远 程 仓库 可 以 在 不 同 的 本 地 开发 环境 之 间 转 移 代 码 。 例 如 ， 
你 可 以 同时 在 一 个 笔记 本 和 一 个 台式 机 上 工作 。 远 程 仓库 是 在 不 同 地 方 工作 ， 让 代码 流动 
的 好 办 法 ， 这 样 你 甚至 可 以 在 切换 了 机 器 之 后 继续 工作 。 


如 果 你 完成 了 本 章 前 面 的 练习 ， 那 么 现在 应 该 知道 你 有 三 个 本 地 仓库 : 一 个 从 GitLab 仓库 
克隆 下 来 的 仓库 ， 一 个 从 下 载 的 zip 压缩 包 创 建 的 仓库 ， 以 及 一 个 从 空 目录 创建 而 来 的 第 
三 个 仓库 。 这 些 仓库 都 是 本 地 的 ， 你 无 法 将 你 的 工作 共享 给 别人 ， 因 为 它们 没有 与 之 相关 
的 远程 仓库 (从 压缩 包 创建 的 仓库 和 在 本 地 初始 化 的 仓库 )， 或 者 你 没有 远程 仓库 的 写 入 
权限 (你 克隆 的 仓库 )。 


为 了 上 传 你 的 工作 ， 你 将 需要 在 GitLab 上 创建 一 个 新 的 项 目 ， 并 将 它 与 你 的 一 个 已 有 仓库 
关联 起 来 。 


5.6.1 创建 新 的 项 目 


如 果 你 还 没有 远程 仓库 ， 那 么 将 需要 在 GitLab.com (https://gitlab.com/) 上 注册 一 个 账户 
(这 是 免费 的 ) 并 登录 你 的 帐户。 你 也 可 以 用 GitHub, Twitter 或 Google 账户 登录 。 尽 管 你 
可 以 在 其 他 代码 托管 系统 中 完成 这 些 步 又， 例如 GitHub, fH GitLab 是 一 个 开源 产品 ， 如 
果 你 需要 在 防火 墙 后 练习 源 代 码 控制 ， 那 么 可 以 在 上 面 免 费 托管 你 的 项 目 。 


(1) 登录 你 的 GitLab 账户 并 前 往 你 的 信息 中 心 页 面 (https://gitlab.com/)。 
(2) 从 项 目 摘要 选项 卡 中 ， 点 击 New project 按钮 。 

(G3) 输 入 项 目 路 径 ， 如 gitforteams。 其 余 字 段 使 用 默认 值 即 可 。 

(4) 点 击 Create project。 你 将 会 被 重新 定向 到 一 个 指导 页 面 ， 告 诉 你 如 何 上 传 你 的 仓库 。 


5.6.2 ”添加 第 二 个 远程 连接 


GitLab 为 你 提供 了 只 要 复制 粘贴 即 可 的 指令 ， 帮 助 你 将 仓库 上 传 至 这 个 平台 。 不 过 ， 你 
` 会 希望 完成 所 有 步骤 。 从 你 的 新 项 目 页 面 上 ， 查 看 第 二 部 分 ， 创 建 一 个 新 的 仓库 〈 例 
5-28). 


例 5-28 在 GitLab 上 创建 一 个 新 仓库 
mkdir my-git-for-teams 
cd my-git-for-teams 
git init 
touch README.md 
git add README.md 
git commit -m "first commit" 
git remote add origin git(gitlab.com:emmajane/my-git-for-teams.git 
git push -u origin master 


如 果 你 已 经 在 本 地 创建 过 一 个 仓库 ， 那 么 能 否 看 到 你 应 该 从 哪 一 步 开 始 ? (提示 : 与 标签 
为 Push an existing Git repository 的 部 分 相 比 。) 你 已 经 完成 了 git remote add origin 这 行 
之 前 的 所 有 步骤 。 如 果 你 希望 从 头 开 始 创建 一 个 新 的 仓库 ， 遵 循 所 有 的 指令 即 可 ， 然 而 你 
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现在 已 经 有 了 三 个 本 地 仓库 ! 与 其 〈 再 次 ) 创建 一 个 新 的 仓库 ， 不 如 通过 添加 一 个 远程 连 
接 来 将 三 个 仓库 中 的 一 个 上 传 至 GitLab 中 的 新 项 目 。 选 择 三 个 仓库 中 的 哪 一 个 设 有 关系 ， 
但 你 只 能 选择 一 个 ， 因 为 每 个 项 目 对 应 着 一 个 独立 的 仓库 。 
当 你 将 一 个 远程 连接 加 入 到 仓库 中 时 ， 必 须 为 它 分 配 一 个 别名 ( 例 $-29)。 默 认 情 况 下 ， 
这 个 别名 是 origin。 你 可 以 用 任何 你 喜欢 的 东西 命名 ， 比 如 pickles, peanutbutter 和 
kittens, Git 并 不 关心 你 选择 的 名 称 。 使 用 origin 的 优点 是 你 可 以 复制 、 粘 贴 更 多 网 上 的 
教程 ,缺点 是 origin 不 一 定 符合 语义 ， 尤 其 是 当 你 的 仓库 事实 上 是 从 本 地 起 步 时 。 除 此 
之 外 ，origin 在 你 克隆 远程 仓库 时 已 经 被 占用 了 。 为 了 连接 为 三 个 本 地 仓库 创建 的 远程 仓 
库 ， 我 使 用 了 my_gitlab 这 个 别名 。 
例 5-29 使 用 自 定义 的 名 称 在 本 地 仓库 中 添加 远程 连接 

$ git remote add my gitlab git@gitlab.com:emmajane/my-git-for-teanms.git 
直到 我 最 终 学 会 管理 Git 中 的 命名 ， 我 才 真正 开始 理解 所 有 部 分 是 如 何 拼 到 一 起 的 。 例 如 ， 
我 通常 将 代码 托管 系统 的 名 称 作为 将 远程 连接 的 别名 。“Git 团队 协作 ”仓库 的 本 地 副本 有 
以 下 远程 仓库 : github, gitlab 和 bitbucket ( 例 5-30), 
确认 已 通过 renote 命令 正确 添加 远程 仓库 ， 如 例 5-30 所 示 。 
例 5-30 列 出 连接 至 你 当前 仓库 的 远程 仓库 

$ git remote --verbose 
如 果 你 已 经 将 这 个 远程 连接 分 配给 了 你 克隆 的 仓库 ， 那 么 将 会 看 到 下 列 两 对 远程 连接 。 


my_gitlab git@gitlab.com:emmajane/my-git-for-teams.git (fetch) 
my_gitlab git@gitlab.com:emmajane/my-git-for-teams.git (push) 
origin git@gitlab.com:emmajane/gitforteams.git (fetch) 
origin git(gitlab.com:emmajane/gitforteams.git (push) 


你 现在 可 以 将 你 的 工作 从 任何 分 支 推送 到 你 的 远程 仓库 。 


5.6.3 推送 你 的 更 改 

为 了 上 传 你 的 修改 ， 你 需要 远程 仓库 的 连接 、 发 布 到 仓库 的 权限 和 你 想 要 上 传 修改 的 分 
支 名 。 在 你 第 一 次 推送 分 支 时 ， 需 要 明确 告诉 Git 将 这 些 东 西 放 在 什么 位 置 。 如 果 你 使 用 
push 来 推送 修改 ， 它 会 告诉 你 下 一 步 怎么 做 。 

免 去 输入 密码 的 麻烦 

如 果 你 还 没有 将 你 的 SSH. 密 钥 添加 到 代码 托管 系统 (参见 附录 D), MAK 
需要 在 每 次 推送 修改 前 输入 你 的 用 户 名 和 密码 。 














































































































例如 ， 如 果 你 正在 使 用 1-process notes 分 支 ， 并 且 想 将 它 推 送 至 远程 仓库 (Al 5-31)， 那 
么 将 会 得 到 一 条 错误 消息 ( 例 5-32)。 
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f| 5-31 使 用 push 命令 上 传 分 支 


$ git push 


例 5-32 在 没有 上 游 分 支 时 ， 你 将 会 得 到 一 条 错误 消息 
fatal: The current branch 1-process_notes has no upstream branch. 
To push the current branch and set the remote as upstream, use 





git push --set-upstream origin 1-process notes 


这 条 错误 消息 为 我 们 提供 了 非常 有 用 的 信息 ， 但 可 能 并 不 完全 正确 。 与 其 说 是 将 你 的 分 支 
上 传 到 远程 仓库 origin， 不 如 说 我 们 事实 上 想 要 使 用 新 的 远程 仓库 my_gitlab ( 例 5-33)。 
例 5-33 在 上 传 本 地 分 支 时 设置 上 游 分 支 
$ git push --set-upstream my gitlab 1-process notes 

这 个 命令 将 会 上 传 你 的 分 支 并 且 准 备 好 在 未 来 使 用 。 现 在 不 论 你 什么 时 候 使 用 这 个 分 支 ， 
你 都 可 以 使 用 简单 得 多 的 命令 git push 来 上 传 你 的 工作 。 通 过 设置 上 游 连 接 ， 事 实 上 你 
立 了 本 地 分 支 副 本 和 远程 仓库 之 间 的 关联 。 这 与 --track 签 出 一 个 远程 分 支 的 作用 是 相同 
的 ， 除 了 在 这 个 例子 中 ， 你 一 开始 使 用 的 是 远程 的 副本 并 随后 添加 了 一 个 跟踪 的 本 地 副本 。 


5.6.4 分支 维 护 

一 旦 代码 经 过 了 完整 的 测试 ， 你 就 会 希望 将 这 个 工 单 分 支 并 入 master 分支 ( 例 5-34) 并 
删除 本 地 分 支 ( 例 5-35) 和 这 个 工 单 分 支 ( 例 5-36) 的 远程 副本 。 在 单 人 团队 中 ， 你 不 太 
可 能 需要 处 理 合 并 冲突 。 合 并 冲突 将 在 第 7 章 中 介绍 。 

例 5-34 将 工 单 分 支 并 入 你 的 主 分 支 


$ git checkout master 
$ git merge 1-process_notes 


如 果 需 要 执行 真正 的 合并 ， 而 不 只 是 快 进 历史 记录 ， 或 许 会 弹出 一 个 编辑 器 让 你 编写 提交 
消息 。 一 般 我 使 用 默认 的 消息 。 一 旦 工作 被 并 入 master 分 支 ， 你 同样 应 该 将 master 分 支 
推送 到 远程 仓库 ， 如 下 所 示 。 

$ git push --set-upstream my gitlab master 
现在 ， 修 改 已 经 被 并 入 master 分 支 ， 没 有 必要 继续 保留 这 个 工 单 分 支 了 。 为 了 保持 你 的 仓 
库 整 洁 ， 你 可 以 更 进一步 ， 现 在 删除 这 个 工 单 分 支 ( 例 5-35). 
例 5-35 ”删除 这 个 分 支 的 本 地 副本 

$ git branch --delete 1-process notes 
如 果 还 有 没有 并 入 其 他 分 支 的 修改 ，Git 会 不 断 提 醒 你 ， 因 此 你 不 需要 GEF) 担心 丢失 
未 保存 的 工作 。 
最 后 ， 你 同样 需要 在 远程 仓库 做 一 些 清 理工 作 。 你 还 应 该 删除 那些 修改 已 并 入 master 分 支 
的 远程 分 支 ( 例 5-36). 
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5.7 


清 


删除 不 再 需要 的 远程 分 支 


$ git push --delete my gitlab 1-process notes 


命令 指南 


表 5-1 列 出 了 本 章 用 到 的 所 有 命令 。 



































理 结束 时 ， 是 时 候 为 你 的 下 一 个 新 想法 重复 这 个 步骤 了 。 


这 些 命令 均 为 shell 命令 ,使 用 方式 如 下 所 示 。 





表 5-1: 基本 的 shell 命 令 
命令 用 途 
cd ~ 转 到 你 的 home 目录 
mkdir 创建 新 目录 
cd directory_name 转 到 指定 目录 
ls -a 在 OS X 和 基于 Linux 的 系统 下 列 出 隐藏 文件 
dir 在 Windows 下 列 出 文件 
touch file name 使 用 指定 名 称 创 建新 的 空 文件 











表 5-2 列 出 了 Git 应 用 使 用 的 子 命令 。 在 命令 行 中 ， 它 们 总 是 以 命令 git HK. 





表 5-2: 基本 的 Git 命 令 

命令 用 途 

git clone URL 下 载 一 份 远 程 仓库 的 副本 

git init 将 当前 目录 转换 成 一 个 新 的 Git 仓库 
git status 获取 仓库 状态 报告 

git add --all 将 所 有 修改 过 的 文件 和 新 文件 添加 至 仓库 的 暂 存 区 
git commit -m "message" 将 所 有 和 暂 存 的 文件 提交 至 仓库 

git log 查看 项 目 历史 

git log --oneline 查看 压缩 过 的 项 目 历 史 

git branch --list 列 出 所 有 本 地 分 支 

git branch --all 列 出 本 地 和 远程 分 支 

git branch --remotes 列 出 所 有 远程 分 支 

git checkout --track remote name/branch 创建 远程 分 支 的 副本 ， 在 本 地 使 用 
git checkout branch 切换 到 另 一 个 本 地 分 支 


checkout -b branch branch parent 
add filename(s) 

add --patch filename 

reset HEAD filename 

commit --amend 
show commit 


tag tag commit 













































































从 指定 分 支 创建 一 个 新 分 支 


仅 暂 存 并 准备 提交 指定 文件 
仅 暂 存 并 准备 提交 部 分 文件 



































从 暂 存 区 移 除 提出 的 文件 修改 

使 用 当前 暂 存 的 修改 更 新 之 前 的 提交 ， 并 提供 一 个 
新 的 提交 消息 

输出 某 个 提交 的 详细 信息 

为 某 个 提交 对 象 打上 标签 
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命令 用 途 

git tag 列 出 所 有 标签 

git show tag 输出 所 有 带 标签 提交 的 详细 信息 

git remote add remote name URL 创建 一 个 指向 远程 仓库 的 引用 

git push 将 当前 分 支 上 的 修改 上 传 至 远程 仓库 

git remote --verbose 列 出 所 有 可 用 远程 连接 中 fetch 和 push 命令 使 用 的 
URL 

git push --set-upstream remote name branch local 将 本 地 分 支 的 副本 推送 至 远程 服务 器 

branch_remote 

git merge branch 将 当前 存储 在 另 一 分 支 的 提交 并 入 当前 分 支 

git push --delete remote name branch remote 在 远程 服务 器 中 移 除 指定 名 称 的 分 支 





5.8 ”小结 

在 本 章 中 ， 你 已 经 学 会 了 如 何在 单 人 团队 中 使 用 Git。 下 面 是 在 本 章 中 列 出 的 最 佳 实践 。 

。 总 是 在 开始 工作 前 定义 好 你 要 做 的 事情 。 这 将 会 帮助 你 决定 分 支 的 名 称 ， 以 及 你 想 要 从 
哪个 分 支 开 始 工作 。 

。 当 你 在 自己 的 分 支 上 进行 修改 时 ， 可 以 将 其 中 一 些 修 改 或 所 有 修改 添加 至 暂 存 区 。 这 能 
够 帮助 你 确保 一 个 提交 只 包含 相关 的 工作 。 

。 无 论 你 是 在 本 地 新 建仓 库 还 是 克隆 一 个 仓库 ， 你 总 是 可 以 在 代码 托管 系统 上 创建 一 个 新 
的 项 目 ， 然 后 通过 在 本 地 仓库 中 添加 一 个 新 的 远程 来 上 传 你 的 工作 。 

。 清理 任务 应 该 在 你 完成 每 行 工作 后 进行 。 你 可 以 将 工 单 分 支 并 入 主 分 支 ， 然 后 删除 分 支 
的 本 地 和 远程 副本 。 

在 下 一 章 中 ， 你 将 会 学 到 如 何 通 过 Git 时 光 机 回 到 从 前 ， 撤 销 你 的 工作 以 及 修改 你 的 提交 

历史 。 

































































第 6 章 


回 滚 、 还 原 、 重 置 和 变 基 





本 章 也 称 为 “糟糕 ”的 一 章 。 毕 竟 好 人 也 会 遇 上 坏事 。 幸 和 运 的 是 ，Git 可 以 让 你 穿越 回去 ， 
撤销 已 经 犯 下 的 错误 。 根 据 错 误 的 严重 程度 ，Git 提供 了 不 同 的 命令 ， 轻 则 微调 一 条 提交 
消息 ， 重 则 抹 除 历史 记录 。 错 误 的 提交 和 移 除 通常 都 发 生 在 个 人 仓库 中 ， 但 你 处 理 错 误 的 
方式 将 会 影响 到 其 他 人 与 代码 库 的 交互 。 确 保 你 总 是 以 最 友好 的 方式 处 理 问题 ， 帮 助 你 的 
团队 更 加 高 效 地 工作 。 

完成 本 章 学 习 之 后 ， 你 将 具备 以 下 技能 。 

。 修补 一 个 提交 ， 并 加 入 新 的 工作 

。 将 一 份 文 件 恢复 到 之 前 的 状态 

。 将 你 的 工作 目录 恢复 到 上 次 提交 时 的 状态 

。 还 原 之 前 作出 的 变更 

。 使 用 变 基 重 塑 提交 历史 记录 

。 从 仓库 中 移 除 一 份 文件 

。 移 除 某 个 分 支 上 因为 错误 的 合并 引入 的 提交 

在 本 章 中 ， 你 将 会 学 习 容易 被 忽略 、 但 影响 巨大 的 使 用 技巧 。 放 慢 节 奏 ， 画 图 思考 一 下 ， 
在 运行 一 系列 命令 后 你 期 望 出 现 什 么 样 的 结果 。 这 样 你 可 以 选择 正确 的 子 命令 和 正确 的 参 
数 。 同 时 ， 这 样 做 还 有 助 于 你 在 下 次 需要 执行 相同 任务 时 回忆 起 这 些 信息 。 

喜欢 通过 视频 教程 学 习 的 读者 可 以 参考 本 书 附带 的 系列 视频 ，Collaborating with Git (http:// 
shop.oreilly.com/product/0636920034872.do) 。 


r3 + 
6.1 最 佳 实 践 
在 本 章 中 ， 你 将 会 学 习 如 何 操作 你 的 仓库 历史 记录 。 尽 管 本 书 中 的 练习 易于 上 手 ， 但 压力 
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你 将 工作 提交 到 了 仓库 ， 只 要 愿意 搜寻 下 去 ， 那 么 〈 几 乎 ) 总 是 能 够 找到 这 些 工作 。 在 
Git 中 很 难 将 工作 完全 删除 ， 但 相对 来 说 容易 丢失 工作 后 找 不 回来 。 因 此 ， 在 你 学 会 修补 
历史 记录 前 ， 确 保 你 有 趁 手 的 恢复 工具 来 帮助 你 摆脱 困境 。 


6.1.1 描述 问题 


在 Git 中 有 很 多 方法 都 可 以 撤销 工作 ， 不 同 的 方法 适用 于 不 同 的 情形 。 为 了 选择 正确 的 方 
法 ， 你 需要 确切 知道 你 想 要 修改 什么 ， 以 及 在 修改 后 会 发 生 什么 变化 。 在 我 初学 版 本 控制 
时 ， 通 常会 快速 画 个 草图 来 描述 我 想 要 完成 的 工作 ， 确 保 自 己 会 使 用 正确 的 命令 来 完成 工 
作 。 图 6-1 显示 了 你 应 该 了 解 的 三 个 概念 : 工作 目录 (你 的 文件 系统 中 可 见 的 文件 )、 暂 存 
区 (在 下 一 次 commit 后 即将 写 入 仓库 的 变更 的 索引 ) 和 仓库 (储存 文件 并 记录 了 文件 的 每 
次 变更 )。 





















































储存 的 文件 





可 见 的 文件 

















储存 的 文件 与 可 见 的 文件 之 间 的 差 集 








图 6-1: 工作 区 、 暂 存 区 和 仓库 分 别 包含 你 的 文件 的 不 同 信息 


暂 存 区 不 会 自动 更 新 


图 6-1 中 有 些 地 方 不 那么 准确 ， 因 为 你 需要 使 用 add 命令 来 显 式 地 将 工作 放 
入 暂 存 区 ， 但 对 你 来 说 ， 这 是 一 个 易于 上 手 的 工作 模型 。 


























Git 将 信息 存放 在 不 同 地 方 ， 当 你 将 问题 隔离 在 这 些 不 同 的 地 方 时 ， 将 能 够 更 好 地 选择 正 
确 的 命令 序列 ， 将 工作 恢复 到 你 想 要 的 状态 。 表 6-1 总 结 了 你 在 使 用 Git 时 可 能 遇 到 的 一 
系列 场景 。 


表 6-1: 选择 正确 的 撤销 方法 


























你 想 要 …… 备注 解决 方案 

舍弃 工作 目录 中 对 一 个 文件 的 修改 修改 的 文件 未 被 暂 存 或 提交 checkout -- filename 
舍弃 工作 目录 中 所 有 未 保存 的 变更 文件 已 暂 存 ， 但 未 被 提交 reset --hard 

合并 与 某 个 特定 提交 (但 不 含 ) 之 间 的 reset commit 

多 个 提交 

移 除 所 有 未 保存 的 变更 ， 包 含 未 跟踪 的 修改 的 文件 未 被 提交 clean -fd 

文件 
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你 想 要 …… 备注 解决 方案 

移 除 所 有 已 暂 存 的 变更 和 在 某 个 提交 之 reset --hard commit 
前 提交 的 工作 ， 但 不 移 除 工作 目录 中 的 

新 文件 


移 除 之 前 的 工作 ， 但 完整 保留 提交 历史 分 支 已 经 被 发 布 ， 工 作 目录 是 revert comit 
记录 (“前 进 式 回 滚 ”) 干净 的 

从 分 支 历 史记 录 中 移 除 一 个 单独 的 提交 修改 的 文件 已 经 被 提交 ， 工 作 rebase --interactive commit 
目录 是 干净 的 ， 分 支 尚 未 进行 

发 布 

保留 之 前 的 工作 ,但 与 男 一 提交 合并 ”选择 squash (压缩 ) 选项 rebase --interactive commit 

图 6-2 显示 了 第 一 种 场景 的 图 像 。 其 他 问题 的 答案 可 以 在 “Git 团队 协作 ”网 站 (http:// 
gitforteams.com/) 上 找到 。 
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E 确 的 文件 潍 误 的 修改 














图 6-2: 你 希望 舍 奔 工作 目录 中 对 一 个 文件 的 修改 ， 错 误 的 文件 副本 没有 被 暂 存 或 提交 


正如 表 6-1 列 出 的 示例 ， 使 用 不 同 的 参数 会 造成 一 些 命令 出 现 两 种 不 同 的 结果 。 你 可 以 在 
图 6-3 的 流程 图 中 找到 你 所 处 的 场景 。 在 纸 上 或 电脑 上 重新 画 一 遍 这 张 图 。 重 画 一 饥 图 通 
篆 比 看 一 页 书 更 容易 记 住 ， 当 你 以 后 在 Git 中 遇 到 这 些 选 项 时 你 会 有 更 次 的 印象 ， 还 可 以 
参考 当时 画 的 这 张 图 。 
你 也 可 以 写 下 你 自己 想 要 从 中 恢复 的 更 改 类 型 。 创 建 一 个 列表 ， 列 出 所 有 你 想 要 从 中 恢复 的 
问题 场景 。 问 题 描 述 得 越 好 ， 就 越 有 可 能 找到 正确 的 解决 方案 。 在 阅读 本 章 时 ， 你 可 以 选择 
在 图 6-3 中 的 流程 图 上 扩展 ， 或 是 创建 你 自己 的 图 。 记 得 在 Twitter 上 用 #gitforteams (https:// 
twitter.com/search?q-9623gitforteams&src-typd) 标签 分 享 你 的 工作 。 我 期 待 看 到 你 的 想法 ! 


6.1.2 ”使 用 分 支 进行 试验 性 的 工作 

在 分 支 树 上 ， 一 个 分 支 与 它 的 兄弟 分 支 是 相互 独立 的 。 尽 管 它们 可 能 有 共同 的 祖先 分 支 ， 
你 (通常 ) 可 以 看 到 在 树 上 移 除 一 个 分 支 却 不 会 影响 到 其 他 分 支 。 在 Git 中 ， 你 添加 到 仓 
库 中 的 提交 与 一 个 或 多 个 分 支 相 关联 。 如 果 你 签 出 一 个 不 同 的 分 支 ， 并 在 这 个 新 的 分 支 上 
操作 提交 对 象 ， 那 么 系统 会 给 这 些 提 交 对 象 分 配 一 个 新 的 标识 符 ， 而 绑 定 到 旧 分 支 上 的 









































































































































回 滚 、 还原、 重 置 和 变 基 | 85 











提交 对 象 不 会 改变 。 这 也 就 是 说 ， 在 新 的 私有 分 支 中 了 
时 ， p 








了 将 你 的 分 支 并 入 主 分 支 (图 6-4). 





[ 作 一 定 是 安全 的 ， 当 你 对 结 
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你 想 要 移 除 一 些 
对 文件 的 更 改 。 








更 改 是 否 


已 经 提交 ? 











checkout -- «filename» 








这 些 修改 是 否 位 
于 你 想 要 保存 的 
作 目 录 中 ? 





























reset --hard 
reset «filename» 





提交 





rebase --interactive <commit> 





这 些 
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reset --hard «commit 
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于 你 想 要 保存 的 





revert «commit 
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不 应 该 重 写 
已 有 历史 。 












reset «commit? 
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0p x 


图 6-3: 创建 一 个 流程 图 来 帮助 你 选择 合适 的 命令 
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图 6-4: 在 分 支 中 工作 帮助 你 免 遭 意外 的 修改 ， 在 工作 正确 且 完 整 后 再 将 它 并 入 主 分 支 


之 前 ， 我 们 将 工 单 作为 创建 和 删除 分 支 的 起 点 。 但 如 果 你 在 一 个 工 单 上 进行 工作 ， 但 不 确 
定 应 该 使 用 两 种 方法 中 的 哪 一 种 。 在 这 种 情况 下 ， 你 可 以 从 你 的 工 单 分 文 上 创建 一 个 新 的 
分 支 ， 在 新 的 分 支 上 进行 试验 性 的 修改 〈 例 6-1) ， 如 果 你 想 要 保存 这 些 修改 ， 再 将 试验 性 
的 分 支 并 和 人 你 的 工 单 分 支 〈 例 6-2)。 


例 6-1 使 用 试验 性 的 分 支 来 测试 修改 
$ git checkout -b experimental idea 
(完成 工作 ) 
$ git add --all 
$ git commit 


在 你 的 试验 性 分 支 上 ， 你 可 能 有 一 个 或 多 个 提交 。 当 你 合并 两 个 分 支 时 ， 可 以 选择 使 用 带 
有 - -squash 参数 的 合并 ， 以 将 所 有 提交 并 入- 个 提交 。 通 过 这 种 方式 合并 分 支 ， 以 后 你 
将 不 能 撤销 分 支 合并 。 基 于 这 个 考虑 ， 只 有 在 合并 你 本 来 就 不 希望 分 离 的 分 支 时 ， 才 使 用 
--squash, 

例 6-2 将 你 的 试验 性 分 支 合 并 回 主 分 支 


$ git checkout master 
$ git merge experimental_idea --squash 





















































Squash commit -- not updating HEAD 
Automatic merge went well; stopped before committing as requested 


$ git commit 
在 合并 后 ， 你 可 以 删除 你 的 试验 性 分 支 〈 例 6-3)。 
例 6-3 删除 你 的 试验 性 分 支 


$ git branch --delete experimental idea 
如 果 你 希望 舍弃 试验 性 的 想法 ， 完 成 最 开始 的 步骤 ， 省 略 把 工作 并 和 人 主 工 单 分 支 这 一 步 。 
要 删除 一 个 未 合并 的 分 支 ， 你 需要 使 用 -D 参数 而 不 是 --delete 参数 。 
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本 章 后 续 的 小 节 中 介绍 了 如 何 移 除 那些 在 你 意识 到 它们 只 是 试验 性 的 修改 之 前 就 已 经 在 分 
支 上 做 出 的 提交 。 


6.2 分 步 变 基 


在 rebase、reset 和 revert 三 个 命令 中 ，rebase 是 唯一 作用 不 局 限于 撤销 工作 的 命令 。 一 
般 来 说 ， 当 我 们 谈论 变 基 时 ， 我 们 指 的 是 使 用 父 分 支 上 的 提交 来 更 新 一 个 分 支 的 过 程 。 通 
第 这 个 过 程 非常 直截了当 : 在 你 想 要 更 新 的 分 支 上 上， 运行 rebase 命令 并 使 用 父 分 支 的 名 称 
作为 参数 。Git 将 你 的 提交 从 工作 所 在 的 子 分 支 上 移 除 ， 并 将 父 分 支 上 产生 的 新 提交 添加 到 
你 的 分 支 顶端 。 这 样 做 看 上 去 你 的 提交 被 放 在 了 父 分 支 中 新 增 的 修改 后 。 打 个 比方 ， 这 就 
好 像 是 Git 吹 着 口哨 假装 什么 都 没有 发 生 ， 但 其 实 趁 你 不 广 意 偷 偷 地 把 一 盆花 搬 上 了 桌子 。 
尽管 我 们 通常 将 变 基 称 为 “重演 你 的 历史 记录 ” ， 但 它 更 准确 的 定义 应 该 是 回 到 之 前 ， 试 
着 重新 创建 历史 记录 。 如 果 你 看 过 《 回 到 未 来 》( 或 者 现在 类 似 的 时 空 穿 越 片 ) ， 你 就 会 知 
道 历史 记录 永远 不 可 能 与 之 前 完全 相同 。rebase 也 是 如 此 。 尽 管 看 上 去 提交 被 转移 到 了 一 
个 新 的 分 支 的 顶端 ， 但 事实 上 它们 是 全 新 的 提交 ， 有 着 自己 的 引用 ID。 当 你 将 这 些 提交 
应 用 到 时 间 线 上 去 时 ， 如 果 新 的 历史 记录 和 你 尝试 应 用 的 工作 发 生 了 冲突 ， 那 么 问题 就 来 
了 。 你 将 会 处 于 分 离 式 HEAD 状态 。 晕 了 吗 ? 还 有 另 一 种 思考 的 方式 : Git 允许 我 们 重新 讲 
述 历 史记 录 ， 我 们 可 以 随意 插入 新 的 事件 。 但 是 ， 事 实 上 它 不 允许 我 们 改变 任何 已 经 发 生 
的 事情 。 木 已 成 舟 ， 我 们 能 做 的 只 有 改变 我 们 讲述 故事 的 方式 。 

在 大 多 数 时 间 里 ， 在 使 用 rebase 命令 更 新 分 支 时 ， 这 个 过 程 非常 迅速 并 且 是 自动 完成 的 。 
但 是 ， 如 果 在 变 基 过 程 中 ， 你 完成 的 工作 与 你 试图 放 到 父 分 支 上 的 工作 出 现 了 有 冲突 的 修 
改 ， 这 个 过 程 将 会 停止 ，Git 会 要 求 你 在 继续 之 前 先 手 动 解决 冲突 。 这 个 冲突 可 能 是 文件 
内 的 修改 ， 也 可 能 是 删除 文件 (其 中 一 方 删 除了 另 一 方 编辑 过 的 文件 )。 而 Git 只 是 一 个 简 
单 的 内 容 跟踪 工具 。 如 果 总 是 由 你 这 位 专家 给 出 合适 的 冲突 解决 方案 ， 那 么 最 终 的 产品 质 
量 将 会 更 好 。 即 使 你 希望 Git 能 够 自己 解决 ， 但 让 它 停 下 来 向 你 寻求 帮助 总 是 没 错 的 。 把 
这 看 作 是 人 生 中 的 一 个 宝贵 的 教训 吧 : 向 别人 求助 没什么 大 不 了 的 。 

rebase 造成 困扰 的 第 二 个 原因 是 当 它 被 用 于 强制 更 新 公共 分 支 时 。 在 这 种 情况 下 ， 时 间 线 
上 将 会 出 现 两 个 〈 或 多 个 ) 拥有 不 同 ID 的 提交 对 象 ， 它 们 包含 相同 的 代码 。 为 了 帮助 你 
选择 应 该 采用 变 基 还 是 合并 ， 请 参考 变 基 、 合 并 决策 树 (http://gitforteams.com/resources/ 
merge-rebase.html) 。 


本 节 剩 余 内 容 描述 在 更 新 分 支 时 遇 到 变 基 中 冲突 的 处 理 流 程 。 在 我 们 的 例子 中 ， 父 分 支 
(或 源 分 支 ) 的 名 称 是 master ， 而 我 们 尝试 更 新 的 分 支 ( 子 分 支 ) 的 名 称 是 feature, 


6.2.1 开始 变 基 
确保 你 父 分 支 的 本 地 副本 与 项 目 主 仓库 中 最 新 的 提交 同步 ， 如 下 所 示 。 


$ git checkout master 
$ git pull --rebase=preserve remote nickname master 
































































































































若 有 必要 ， 请 显 式 指定 参数 

在 使 用 pull 命令 更 新 一 个 分 支 的 本 地 副本 时 ， 参 数 中 远程 连接 和 远程 分 支 
的 名 称 通常 是 可 以 忽略 的 。 有 些 时 候 ， 如 果 一 个 仓库 拥有 多 个 远程 连接 ，Git 
有 时 会 遗漏 可 用 的 更 新 。 加 上 这 两 个 额外 的 参数 或 许 会 有 帮助 。 














Uk 


前 分 支 上 的 修改 与 主 项 目 不 同 步 ， 而 主 项 目 中 的 新 工作 尚未 被 ?1 入 ， 如 下 所 示 。 
$ git checkout feature 

开始 变 基 过 程 ， 如 下 所 示 。 

$ git rebase master 


如 果 没 有 冲突 ，Git 将 会 愉快 地 跳 过 这 个 过 程 并 将 你 带 到 另 一 个 终点 ， 不 需要 你 再 进行 任 
何 附加 操作 。 看 到 了 吗 ? 变 基 是 很 容易 的 ! 你 应 该 试 一 试 ! 但 是 ， 有 些 时 候 我 们 会 遇 到 冲 


Zieee 


6.2.2 ”文件 删除 造成 的 变 基 中 冲突 


当 你 和 父 分 支 中 新 的 提交 修改 了 同一 行 时 ， 你 在 变 基 时 会 遇 到 冲突 。 作 为 一 个 简单 的 内 容 
跟踪 工具 ，Git 没 法 知道 应 该 保留 哪个 修改 ， 是 我 们 的 ， 还 是 他 们 的 ? 与 其 胡乱 猜 一 个 ， 
不 如 让 Git 停 下 来 寻求 你 的 帮助 。 事 实 上 ， 我 觉得 Git 这 样 做 很 贴心 ， 把 你 当 作 了 解 这 些 
内 容 的 专家 ， 而 不 是 自以为是 ! 只 不 过 ， 这 个 过 程 称 为 “在 分 离 式 HEAD 状态 下 解决 冲突 ”， 
而 不 是 “ 问 你 呢 ， 专 家 ! 应 该 怎么 办 ”。 它 的 用 语 看 上 去 很 可 怕 ， 但 其 实 这 个 过 程 非常 友 
好 。 

为 了 解决 某 个 冲突 ， 你 需要 扮 成 专家 的 样子 ， 帮 助 Git 决定 接 下 来 做 什么 。 

本 节 介 绍 了 一 个 变 基 中 冲突 的 例子 。chl0.asciidoc 文件 在 源 分 支 master 中 被 删除 了 ， 但 我 
在 feature 分 支 上 继续 对 它 进 行 修 改 。Git 在 解决 冲突 的 时 候 会 遇 到 问题 。 我 是 想 要 保留 这 
个 文件 ， 还 是 应 该 删除 它 ? Git 将 我 置 于 分 离 式 HEAD 状态 中 ， 因 此 我 需要 告诉 Git 我 希望 
如 何 继续 ， 如 下 所 示 。 


First, rewinding head to replay your work on top of it... 

Applying: CH10: Stub file added with notes copied from video recording lessons. 

Using index info to reconstruct a base tree... 

A ch10.asciidoc 

Falling back to patching base and 3-way merge... 

CONFLICT (modify/delete): chiO0.asciidoc deleted in HEAD and modified in CH10: 

Stub file added with notes copied from video recording lessons.. Version CH10: 

Stub file added with notes copied from video recording lessons. of chí0.asciidoc 

left in tree. 

Failed to merge in the changes. 

Patch failed at 0001 CH10: Stub file added with notes copied from video 

recording lessons. 

The copy of the patch that failed is found in: 
/Users/emmajane/Git/1234000002182/ .git/rebase-apply/patch 





























When you have resolved this problem, run "git rebase --continue". 
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If you prefer to skip this patch, run "git rebase --skip" instead. 
To check out the original branch and stop rebasing, run "git rebase --abort". 


与 这 个 输出 相关 的 信息 如 下 所 示 。 


When you have resolved this problem, run "git rebase --continue". 
此 信息 告诉 我 需要 按 以 下 步骤 操作 。 
(1) 解决 合并 冲突 。 
(2) 当 我 认为 合并 冲突 已 经 被 解决 时 ， 运 行 下 面 的 命令 。 
git rebase --continue 
使 用 我 喜欢 的 文件 对 比 工 具 打 开 有 问题 的 文件 ， 完 成 第 1 步 。 
$ git mergetool ch10.asciidoc 
文件 中 不 再 显示 有 合并 冲突 ， 因 此 我 退出 合并 工具 ， 并 继续 进行 Git 提示 的 下 一 步 操 作 ， 
如 下 所 示 。 


$ git rebase --continue 


Git 返回 了 下 面 的 消息 。 


ch10.asciidoc: needs merge 
You must edit all merge conflicts and then 
mark them as resolved using git add 


个 消息 可 没什么 帮助 ! 我 查看 了 那个 文件 ， 发 现 没 有 合并 冲突 。 我 使 用 status 命令 询问 
Git 出 了 什么 问题 ， 如 下 所 示 。 


$ git status 


Git 输出 了 如 下 内 容 。 


rebase in progress; onto 6ef4edb 
You are currently rebasing branch 'ch10' on '6ef4edb'. 
(fix conflicts and then run "git rebase --continue") 
(use "git rebase --skip" to skip this patch) 
(use "git rebase --abort" to check out the original branch) 
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Unmerged paths: 
(use "git reset HEAD <file>..." to unstage) 
(use "git add/rm <file>..." as appropriate to mark resolution) 


deleted by us: ch10.asciidoc 


no changes added to commit (use "git add" and/or "git commit -a" 


啊 ! 我 发 现 了 两 条 线索 。Unmerged paths (uw deleted by us: chí0.asciidoc 这 两 段 
文字 。 好 吧 ， 我 不 希望 这 个 文件 被 删除 。 这 个 信息 很 有 用 ， 因 为 Git 告诉 我 deleted by 
us， 而 我 知道 我 不 希望 删除 这 个 文件 ， aW unstage (取消 暂 存 ) Git 取消 
暂 存 一 个 修改 等 于 是 告诉 Git “你 打算 做 什么 ? 别 那么 做 。 事 实 上 ， 忘 掉 你 对 这 个 文件 的 
所 有 想法 。Git， 重 置 你 的 HEAD ( 头 指 针 )”。 








Git 通过 下 面 的 文字 ， 告 诉 我 如 何 阻止 这 个 变更 发 生 。 

(use "git reset HEAD <file>..." to unstage) 
根据 这 个 消息 的 指导 ， 运 行 下 面 的 命令 。 

$ git reset HEAD ch10.asciidoc 
现在 ， 这 个 命令 所 做 的 事情 其 实 是 清除 暂 存 区 ， 将 指针 回 退 到 最 新 的 一 个 已 知 的 提交 。 由 
于 正 陷 于 变 基 过 程 中 ， 处 在 分 离 式 HEAD 状态 而 不 是 在 一 个 分 支 上 ， 因 此 reset 清除 了 暂 存 
区 ， 并 且 回 到 了 变 基 前 的 最 新 状态 。 在 这 种 情况 下 ， 我 回 到 了 文件 的 旧版 本 ， 这 也 正 是 我 
所 希望 的 。 当 我 继续 变 基 时 ， 我 会 使 用 featuer 分 支 上 最 新 的 版 本 来 替换 这 个 文件 内 容 。 
如 果 我 希望 保留 他 们 对 文件 的 删除 ， 我 应 该 跳 过 这 一 步 ， 根 据 指示 进入 下 一 步 ， 通 过 后 文 
所 述 的 方式 将 文件 添加 到 和 暂 存 区 。 
在 替换 了 我 那个 章节 的 文件 之 后 ， 让 我 们 看 看 Git 给 出 了 怎样 的 线索 让 我 继续 ， 如 下 所 示 。 


$ git status 


Git 的 输出 如 下 所 示 。 


rebase in progress; onto 6ef4edb 
You are currently rebasing branch 'chi10' on '6ef4edb'. 
(all conflicts fixed: run "git rebase --continue") 
























































Untracked files: 
(use "git add <file>..." to include in what will be committed) 


chí8.asciidoc 


nothing added to commit but untracked files present (use "git add" to track) 


这 么 看 来 我 仍然 拥有 这 份 文件 (这 很 棒 ! )， 但 Git 仍然 感到 很 困惑 ， 不 知道 要 怎么 做 ， 
为 据 它 所 知 ， 这 份 文件 应 该 已 经 被 删除 了 。 我 需要 显 式 地 将 这 份 文件 加 回 到 仓库 中 ，Git 
告诉 我 应 该 按 下 面 这 样 做 。 


Untracked files: (use "git add <file>..." to include in what will be 
committed) chi0.asciidoc 


如 果 只 有 一 份 文 件 受 到 影响 ， 这 个 格式 看 上 去 有 些 奇 怪 。 但 在 这 个 例子 中 我 们 有 长 长 的 一 
列 文 件 ， 格 式 清晰 易 懂 。 
根据 Git 的 请 求 ， 我 现在 将 ch10.asciidoc 文件 加 入 暂 存 区 ， 如 下 所 示 。 

$ git add ch10.asciidoc 
到 现在 ， 我 知道 add 命令 只 是 一 个 流程 的 开始 ， 我 还 需要 commit 文件 ， 但 在 变 基 中 这 个 规 
则 有 所 差别 。 我 再 次 查看 status 命令 的 输出 ， 询 癌 Git 接 下 来 该 怎么 做 ， 如 下 所 示 。 

$ git status 
Git 的 输出 如 下 信息 。 


rebase in progress; onto 6ef4edb 
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You are currently rebasing branch 'chi10' on '6ef4edb'. 
(all conflicts fixed: run "git rebase --continue") 


Changes to be committed: 
(use "git reset HEAD «file»... 


to unstage) 


new file: | chi0.asciidoc 


好 ， 这 个 消息 的 意思 是 还 有 要 提交 的 变更 ( 咽 ， 早 就 知道 了 )， 但 它 没有 让 我 提交 这 些 变 
更 。 相 反 ， 它 在 下 面 这 条 消息 中 让 我 继续 变 基 。 


all conflicts fixed: run "git rebase --continue" 


我 使 用 这 个 命令 继续 ， 即 使 我 们 通常 搭配 使 用 add 和 comit 来 保存 修改 ， 如 下 所 示 。 


$ git rebase --continue 


6.2.8 ”单个 文件 合并 冲突 造成 的 变 基 中 冲突 
在 重新 进入 变 基 过 程 后 ，Git 在 重演 提交 时 又 遇 到 了 另 一 个 冲突 。 输 出 如 下 所 示 。 


Applying: CH10: Stub file added with notes copied from video recording lessons. 

Applying: TOC: Adding Chapter 10 to the book build. 

Using index info to reconstruct a base tree... 

M book.asciidoc 

Falling back to patching base and 3-way merge... 

Auto-merging book.asciidoc 

CONFLICT (content): Merge conflict in book.asciidoc 

Recorded preimage for 'book.asciidoc' 

Failed to merge in the changes. 

Patch failed at 0002 TOC: Adding Chapter 10 to the book build. 

The copy of the patch that failed is found in: 
/Users/emmajane/Git/1234000002182/.git/rebase-apply/patch 


























When you have resolved this problem, run "git rebase --continue". 
If you prefer to skip this patch, run "git rebase --skip" instead. 
To check out the original branch and stop rebasing, run "git rebase --abort". 


又 是 一 个 冲突 。Git 好 麻烦 ! 难怪 人 们 都 在 抱怨 变 基 ! 好 吧 ， 至 少 这 次 是 另 一 个 文件 了 
(CONFLICT (content): Merge conflict in Bo asctudoe 我 再 次 仔细 观察 了 status 命 


令 的 输出 ， 看 看 Git 有 没有 给 我 其 他 线索 。 


$ git status 


Git 返回 的 输出 如 下 所 示 。 


rebase in progress; onto 6ef4edb 
You are currently rebasing branch 'chi10' on '6ef4edb'. 
(fix conflicts and then run "git rebase --continue") 
(use "git rebase --skip" to skip this patch) 
(use "git rebase --abort" to check out the original branch) 








Unmerged paths: 
(use "git reset HEAD <file>..." to unstage) 





(use "git add <file>..." to mark resolution) 


both modified: book.asciidoc 


no changes added to commit (use "git add" and/or "git commit -a") 


长 叹 一 口气 。 好 吧 ，Git。 让 我 们 来 看 看 这 个 文件 中 有 什么 冲突 。 


$ git mergetool book.asciidoc 


使 用 我 最 喜欢 的 合并 工具 打开 这 个 文件 ， 我 看 到 这 个 文件 中 确实 有 一 个 合并 冲突 。 这 个 合 
并 冲突 标记 显示 为 三 (ee 。 我 
选择 我 想 要 保留 的 补丁 片段 来 解决 这 个 冲突 。 保 存 文件 ， 关闭 合并 工具 ， 再 次 使 用 status 
命令 询问 Git 是 否 满 意 ， 如 下 所 示 。 


$ git status 


Git 返回 的 输出 如 下 所 示 。 


rebase in progress; onto 6ef4edb 
You are currently rebasing branch 'ch10' on '6ef4edb'. 
(fix conflicts and then run "git rebase --continue") 
(use "git rebase --skip" to skip this patch) 
(use "git rebase --abort" to check out the original branch) 























一 - 








Unmerged paths : 
(use "git reset HEAD <file>..." to unstage) 
(use "git add <file>..." to mark resolution) 


both modified: book.asciidoc 


no changes added to commit (use "git add" and/or "git commit -a" 


个 消息 有 些 误导 人 ， 因 为 我 已 经 修复 了 冲突 。 此 时 ， 我 打开 文件 再 确认 一 次 。 好 ， 没 有 
中 突 。 因 此 ， 我 继续 阅读 下 一 组 指示 : use “git add «file» ..." to mark resolution 和 
both modified: book.asciidoc, Zl pz, 
































一 


$ git add book.asciidoc 


再 次 检查 status， 如 下 所 示 。 


$ git status 


Git 返回 的 输出 如 下 所 示 。 


rebase in progress; onto 6ef4edb 
You are currently rebasing branch 'chi0' on '6ef4edb'. 
(all conflicts fixed: run "git rebase --continue") 








Changes to be committed: 
(use "git reset HEAD <file>..." to unstage) 


modified: book.asciidoc 


和 之 前 一 样 ， 我 没有 一 起 使 用 add 命令 和 commit 命令 。 相 反 ，Git 给 了 我 如 下 的 指示 : all 
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conflicts fixed: run “git rebase --continue”， 因 此 我 继续 变 基 的 流程 ， 如 下 所 示 。 








$ git rebase --continue 


Git 的 输出 如 下 所 示 。 


Applying: TOC: Adding Chapter 10 to the book build. 
Recorded resolution for 'book.asciidoc'. 
Applying: CH10: Outline of GitHub topics 


变 基 的 流程 已 经 全 部 完成 。 我 的 feature 分 支 的 副本 已 是 最 新 ， 包 含 之 前 提交 到 master 分 
支 上 的 变更 。 

在 变 基 时 ， 你 有 很 多 方式 解决 冲突 。 慢 慢 来 ， 仔 细 阅 读 指 示 。 如 果 你 没有 获得 什么 有 用 的 
信息 ， 试 试 status 命令 ， 看 看 Git 有 没有 给 你 什么 更 有 用 的 信息 。 如 果 你 对 眼前 发 生 的 事 
情感 到 十 分 臣 慌 ， 那 么 总 是 可 以 使 用 git rebase --abort 命令 退出 这 个 流程 。 你 将 回 到 开 
台 变 基 前 你 的 分 支 所 处 的 状态 。 


6.3 定位 丢失 的 工作 概述 


在 Git 中 ， 完 全 舍弃 某 个 提交 过 的 工作 是 非常 困难 的 。 但 是 ， 弄 丢 你 的 工作 是 很 容易 的 事 ， 
就 像 我 弄 丢 钥匙 ， 弄 丢 眼 锐 ， 弄 丢 钱 包 和 用 尽 家 人 的 耐心 一 样 。 如 果 你 认为 你 丢失 了 一 些 
工作 ， 那 么 首先 应 该 做 的 事情 是 找到 保存 之 前 工作 的 提交 。1og 命令 显示 了 某 个 分 支 上 的 
提交 ，reflog 命令 列 出 了 在 仓库 的 本 地 副本 中 的 完整 历史 记录 。 也 就 是 说 你 在 从 远程 服务 
器 克隆 下 来 的 仓库 中 工作 时 ，reflog 历史 记录 起 始 于 你 把 仓库 从 仓库 克隆 到 本 地 环境 时 的 
那 一 刻 ， 而 log 历史 记录 将 会 显示 使 用 init 命令 创建 仓库 后 的 所 有 提交 消息 。 
如 果 你 还 没有 一 个 仓库 ， 下 载 一 份 本 书 的 项 目 仓库 ， 比 较 reflog 和 log 两 个 命令 的 输 ! 
( 例 6-4)。 


例 6-4 比较 log 和 ref loo 的 输出 


$ git clone https://gitlab.com/gitforteams/gitforteams.git 









































上 上 








Cloning into 'gitforteams'... 

remote: Counting objects: 1084, done. 

remote: Total 1084 (delta 0), reused 0 (delta 0) 

Receiving objects: 100% (1084/1084), 12.07 MiB | 813.00 KiB/s, done. 
Resolving deltas: 100% (628/628), done. 

Checking connectivity... done. 


$ git log --oneline 

e8d6aff Updating diagram: Adding commit ID reference to rebase. 
ae56a1f Adding workflow diagram for: reset, revert, rebase, checkout. 
2480520 Merge pull request #5 from xrmxrm/1-markdown_fixes 

ee46470 Fix some markdown Issue #1 


$ git reflog 


2f17715 HEAD@{1}: clone: from https://gitlab.com/gitforteams/gitforteams.git 





| ^ 


94 第 6 章 


如 有 果 你 刚刚 克隆 完 仓 库 ， 那 么 在 引用 日 志 中 只 会 看 到 一 行 。 当 
日 志 将 会 逐渐 增加 。 下 面 是 本 书 仓库 的 一 份 样 例 输出 。 


fddi9dc HEAD@{157}: merge drafts: Fast-forward 

af9e2c8 HEAD@{158}: checkout: moving from drafts to mast 
fddi9dc HEAD@{159}: merge ch04: Merge made by the 'recur 
af9e2c8 HEAD@{160}: checkout: moving from ch04 to drafts 
e296faa HEADQ(161): commit (amend): CH04: first draft co 
dd87941 HEAD@{162}: commit: CH04: first draft complete 


这 个 历史 记录 是 私有 的 。 谢 天 谢 地 ， 只 有 你 可 以 看 到 它 ! EG 
些 并 不 影响 代码 的 事情 ， 比 如 签 出 一 个 分 支 




















你 进行 了 更 多 操作 后 ， 引 用 


er 
sive' strategy. 


mplete 


含 你 所 做 的 所 有 事 ， 包 括 那 


log 和 ref Log 这 两 个 命令 都 会 显示 仓库 中 某 个 状态 的 提交 ID。 只 要 你 找到 了 提交 ID, f 
就 可 以 签 出 这 个 提交 ( 例 6-5) ， 及 时 将 代码 库 的 版 本 临时 恢复 到 那个 节点 。 


例 6-5 在 仓库 中 签 出 特定 提交 


$ git checkout commit 


Checking out files: 100% (2979/2979), done. 
Note: checking out 'a94b4c4'. 


You are in 'detached HEAD' state. You can look around, make experimental 
changes and commit them, and you can discard any commits you make in this 
state without impacting any branches by performing another checkout. 


If you want to create a new branch to retain commits you create, you may 
do so (now or later) by using -b with the checkout command again. Example: 


git checkout -b new branch name 


HEAD is now at a94b4c4... Fixing broken URL to the slides from the main README file. 


Was missing the end round bracket. 
当 你 签 出 一 个 提交 时 ， 你 将 与 某 个 分 支 相 连 的 历史 记录 分 离 。 
吓人 。 一 般 情 况 下 ， 当 我 们 在 Git 中 工作 时 ， 我 们 使 用 线性 的 
们 签 出 一 个 提交 时 ， 我 们 处 于 暂停 状态 (图 6-5). 

















不 过 ， 这 并 没有 听 上 去 那么 
方式 来 展现 历史 记录 。 当 我 








这 时 人 们 通常 开始 灰 慌 ， 简 单 地 说 ， 就 是 你 的 头 指 针 处 于 分 离 状 态 下 ! 遵循 Git 提供 的 指 











示 将 会 帮 你 回 到 正确 的 状态 。 如 有 果 你 希望 保存 你 所 在 的 状态 ， 
的 状态 将 会 记录 在 新 的 分 支 上 ， 如 下 所 示 。 


$ git checkout -b restoring old commit 











创建 一 个 新 的 分 支 ， 然 后 你 


此 时 ， 如 果 你 有 什么 忘 了 添加 的 东西 (或 者 你 想 要 删除 不 再 相关 的 旧 工 作 )， 你 可 以 在 新 
的 分 文中 继续 添加 一 些 修复 。 在 你 完成 后 ， 你 需要 决定 如 何 将 新 的 分 支 合 并 回 工 作 分 支 。 





你 可 以 选择 将 新 的 分 支 merge (合并 ) 到 已 有 的 分 支 上 ， 或 者 











只 是 cherry-pick (拣选 ) 一 


些 想 要 保存 的 提交 。 让 我 们 从 合并 开始 ， 因 为 你 在 第 5 章 中 应 该 已 经 熟悉 了 这 个 方式 ， 如 








下 所 示 。 
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$ git checkout working branch 
$ git merge restoring old commit 








checkout «commit 
工作 目录 
(可 编辑 的 文件 ) 











图 6-5: 在 分 离 式 头 指针 状态 下 ， 你 与 分 支 的 线性 历史 记录 暂时 失去 连接 
在 合并 完成 后 ， 你 现在 应 该 删除 临时 分 支 来 整理 你 的 本 地 仓库 ， 如 下 所 示 。 


$ git branch --delete restoring old commit 


如 果 你 已 经 发 布 了 临时 分 支 ， 并 且 和 希望 从 远程 仓库 删除 它 ， 那 么 你 需要 显 式 进行 这 一 步 ， 
如 下 所 示 。 


$ git push --delete restoring old commit 


如 果 临 时 分 支 上 包含 很 多 无 关 的 工作 ， 这 种 方法 可 能 会 造成 巨大 的 混乱 。 在 这 种 情况 下 ， 
使 用 cherry-pick (拣选 ) 命令 可 能 更 为 合适 ( 例 6-6)。 这 个 命令 有 多 种 使 用 方式 一 一 使 
用 git help cherry-pick 命令 查看 它 的 文档 。 我 倾向 于 使 用 我 想 要 复制 到 当前 分 支 的 提交 
ID。 可 选 的 -x 参 数 在 提交 消息 后 增加 了 一 行 ， 告 诉 你 这 个 提交 是 从 别处 拣选 的 ， 而 不 是 
在 当前 分 支 上 原创 的 。 新 增 的 这 一 行使 得 这 个 提交 在 以 后 更 好 辨认 。 


例 6-6 使 用 cherry-pick 将 提交 复制 到 新 的 分 文 


$ git cherry-pick -x commit 


假设 这 些 提交 被 干净 地 应 用 到 了 你 当前 的 分 支 ， 你 将 看 到 如 下 所 示 的 一 条 消息 。 


[master 6b60f9c] Adding office hours reminder. 
Date: Tue Jul 22 08:36:54 2014 -0700 
1 file changed, 2 insertions(+) 


如 果 出 现 了 问题 ， 你 可 能 需要 手动 解决 提交 冲突 。 输 出 将 会 如 下 所 示 。 


error: could not apply 9d7fbf3... Lesson 9: Removing lesson stubs from 
subsequent lessons. 

hint: after resolving the conflicts, mark the corrected paths 

hint: with 'git add «paths»' or 'git rm «paths»' 

hint: and commit the result with 'git commit' 
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合并 冲突 在 第 7 章 中 将 会 更 详细 地 介绍 。 如 果 你 在 拒 选 提交 时 过 到 了 冲突 ， 请 直接 跳 到 那 
一 章 。 

你 可 能 会 遇 到 的 另 一 个 输出 是 : 你 想 要 并 入 的 提交 是 一 个 合并 提交 。 在 这 种 情况 下 ， 你 将 
会 需要 选择 父 分 支 。 你 可 以 通过 试图 拣选 一 个 提交 时 Git 给 出 的 如 下 输出 来 辨别 这 个 情况 。 


error: Commit 0075f7eda6 is a merge but no -m option was given. 
fatal: cherry-pick failed 


确认 你 想 要 保留 的 父 分 支 是 图 形 化 输出 的 日 志 中 左 侧 第 一 个 分 支 ( 从 左 到 右 数 )， 如 下 所 示 。 
$ git log --oneline --graph 

然后 ， 再 次 运行 cherry-pick 命令 ， 这 次 使 用 --mainline 参数 标识 父 分 支 ， 如 下 所 示 。 
$ git cherry-pick -x commit --mainline 1 

最 后 ， 如 果 你 决定 不 保留 恢复 的 工作 ， 可 以 舍弃 这 些 变 更 ， 如 下 所 示 。 


$ git reset --merge ORIG_HEAD 














公共 的 历史 记录 不 应 该 被 修改 
reset 命令 不 应 该 被 用 于 共享 的 分 支 来 移 除 已 经 被 发 布 的 提交 。 撤 销 共 享 分 
支 上 的 变更 将 在 本 章 后 续 内 容 中 提 到 。 











如 有 果 你 练 过 了 本 节 中 的 每 个 例子 ， 你 现在 应 该 可 以 签 出 一 个 提交 ， 创 建 一 个 新 的 分 支 来 从 
分 离 式 HEAD 状态 中 恢复 ， 将 一 个 分 文中 的 变更 合并 到 另 一 个 分 支 ， 将 提交 拣选 到 一 个 分 文 
并 删除 本 地 分 支 。 


6.4 还 原文 件 


如 果 你 在 工作 时 不 小 心 错误 地 删除 了 文件 ， 而 事实 上 你 希望 保留 这 个 文件 。 或 者 可 能 你 编 
辑 了 一 个 不 该 编辑 的 文件 。 在 这 些 修改 被 锁定 (或 提交 ) 前 ， 你 可 以 签 出 这 些 文件 。 你 可 
以 将 文件 内 容 恢复 到 你 当前 所 在 的 分 支 中 最 新 的 已 知 提交 ， 并 储存 这 个 文件 ， 如 下 所 示 。 


$ rm README. md 
$ git status 
































On branch master 
Changes not staged for commit: 


(use "git add/rm <file>..." to update what will be committed) 
(use "git checkout -- <file>..." to discard changes in working directory) 
deleted: README . md 


no changes added to commit (use "git add" and/or "git commit -a") 
状态 消息 说 明了 如 何 撤销 变更 并 恢复 被 删除 的 文件 ， 如 下 所 示 。 


$ git checkout -- README.md 
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如 果 你 已 经 暂 存 了 文件 ， 你 需要 使 用 reset 命令 在 恢复 文件 之 前 将 它 取 消 暂 存 。 为 了 试验 
这 一 点 ， 你 需要 首先 删除 一 个 文件 ， 然 后 使 用 add 命令 将 这 些 修改 添加 到 暂 存 区 ， 最 后 使 
用 status 命令 来 验证 你 的 下 一 步 操作 ， 如 下 所 示 。 


$ rm README. md 
$ git add README.md 








$ git status 


On branch master 
Changes to be committed: 
(use "git reset HEAD <file>..." to unstage) 


deleted: README . md 

此 时 ， 你 之 前 使 用 过 的 checkout 命令 将 不 再 有 有 用。 相反， 遵循 Git 给 出 的 指示 来 取消 暂 存 
你 想 要 恢复 的 文件 ， 使 用 Git 的 HEAD. ( 头 指针 ) 快捷 方式 ， 也 就 是 指向 当前 分 支 最 近 一 次 
提交 的 指针 ， 如 下 所 示 。 

$ git reset HEAD README. md 
一 旦 文件 被 取消 暂 存 后 ， 你 可 以 像 之 前 使 用 checkout 命令 那样 恢复 被 删除 的 文件 ， 如 下 
所 示 。 

$ git checkout -- AEADME.md 
如 果 你 愿意 ， 可 以 把 上 面 两 个 命令 合并 成 一 个 ， 如 下 所 示 。 

$ git reset --hard HEAD -- README.md 
如 果 你 想 要 撤销 工作 目录 中 的 所 有 变更 ， 将 所 有 文件 恢复 到 上 一 个 提交 的 版 本 ， 你 不 需要 
每 次 更 改 一 个 文件 。 你 可 以 批量 完成 这 个 操作 ， 如 下 所 示 。 


$ git reset --hard HEAD 


现在 ， 你 应 该 可 以 恢复 工作 目录 中 被 删除 的 文件 了 。 


6.5 使 用 提交 


提交 是 你 的 仓库 中 某 一 时 刻 的 一 份 快 照 ， 包 含 仓库 中 所 有 文件 的 状态 。 其 中 的 每 个 提交 
都 可 以 在 你 的 历史 记录 中 操作 。 你 可 以 使 用 reset 命令 完全 移 除 这 个 提交 ， 你 可 以 使 用 
revert 命令 反 转 一 个 提交 的 影响 (但 仍 在 历史 记录 中 保留 这 个 提交 )， 你 可 以 使 用 rebase 
命令 修改 提交 的 顺序 。 如 果 你 已 经 发 布 了 这 些 提 交 ， 绝 对 不 要 改变 你 的 仓库 历史 记录 。 这 
是 因为 只 要 稍 加 修改 就 会 导致 它 以 一 个 新 的 提交 SHA 储存 在 仓库 中 ， 即 使 代码 与 分 支 顶 
端的 一 模 一 样 。 这 是 因为 Git 假设 所 有 新 的 提交 ID 包含 必须 记 入 的 新 信息 ， 不 管 这些 提 交 
中 的 文件 内 容 是 否 改变 。 

在 本 节 中 ， 我 们 假设 你 正在 操作 的 提交 尚未 共享 给 其 他 人 (也 就 是 说 ， 你 还 没有 推送 你 的 
分 支 )。 我 们 会 单独 介绍 变更 共享 分 支 的 历史 记录 的 方法 。 



















































































6.5.1. 修补 提交 

如 果 你 意识 到 你 刚刚 创建 的 提交 还 需要 一 点 点 修改 ， 你 可 以 修补 (amend) 这 个 提交 来 引 
入 更 多 文件 或 者 更 新 这 个 提交 的 说 明 。 我 频繁 地 使 用 这 个 命令 来 将 我 简练 的 单行 提交 消息 
转换 成 格式 良好 的 工作 总 结 。 





不 要 改变 共享 的 历史 记录 
如 果 你 已 经 推送 了 工作 ， 回 到 过 去 “修复 ”共享 历史 记录 是 一 个 不 好 的 习惯 。 





如 果 你 在 工作 目录 中 改变 了 文件 ， 你 需要 在 修补 提交 前 将 这 些 文件 添加 (add) 到 暂 存 区 
( 例 6-7)。 如 果 你 只 是 在 更 新 提交 消息 ， 而 设 有 新 的 或 修改 过 的 文件 需要 添加 ， 你 可 以 忽 
W& add 命令 ， 然 后 直接 跳 到 commit 命令 。 
例 6-7 使 用 --anend 更 新 之 前 的 提交 

$ git add --all 

$ git commit --amend 
你 的 新 变更 将 会 被 添加 到 之 前 的 提交 ， 并 且 Git 会 为 这 个 修改 过 的 提交 对 象 分 配 一 个 新 的 ID 
还 有 更 多 的 提交 选项 
构建 你 的 提交 对 象 的 方法 不 止 这 些 。 我 列 出 了 我 最 常 使 用 的 一 些 选 项 。 你 上 
以 阅读 commit 的 相应 教程 页 来 寻找 其 他 用 法 。 你 可 以 通过 运行 下 面 的 命令 
来 访问 这 些 信息 : git help commit, 





























不 过 ， 如 果 你 希望 修补 更 多 提交 ， 你 将 会 用 到 reset 或 rebase, 


6.5.2 ”使 用 reset 合 并 提交 

reset 命令 在 撤销 的 流程 中 扮演 了 很 多 角色 。 在 这 个 例子 中 ， 我 们 会 使 用 它 来 模拟 变 基 时 
squash (压缩 ) 的 作用 。 对 reset 作用 最 基本 的 解释 是 ， 它 其 实 只 是 修改 了 头 指针 的 指向 。 
不 管 你 用 手指 着 哪个 提交 ，Git 都 会 把 它 当 作 你 的 分 支 当 前 的 HEAD. (或 顶端 )。 


reset 会 改变 你 已 记录 的 历史 记录 

reset 将 会 改变 你 的 历史 记录 ， 因 为 它 移 除 了 指向 提交 的 引用 。 如 果 有 人 试 
图 合并 他 们 旧版 本 的 分 支 ， 他 们 将 会 重新 引入 你 尝试 移 除 的 提交 。 因 此 ， 最 
好 只 在 尚未 与 他 人 共享 的 分 支 上 使 用 reset 来 改变 分 支 历 史记 录 (也 就 是 说 
你 本 地 创建 的 分 支 ， 且 你 尚未 将 它 推送 到 服务 器 ) 。 















































之 前 你 使 用 reset 命令 在 提交 前 取消 暂 存 工作 。 这 次 你 将 使 用 reset 来 移 除 你 的 分 支 历史 
记录 中 的 提交 对 象 。 想 象 一 串珠 子 。 假 设 串 上 有 20 粒 珠子 。 担 住 第 四 颗 珠子 ， 让 前 三 个 
从 串 上 请 下 。 你 现在 有 一 串 短 了 一 些 的 珠子 和 三 个 散落 的 珠子 。 你 在 使 用 reset 命令 时 添 
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加 的 参数 决定 了 这 些 珠子 的 命运 。 


如 果 你 希望 舍弃 你 移 除 的 提交 对 象 中 的 内 容 ， 你 需要 使 用 hard 模式 的 reset。 这 个 模式 通 
过 --hard 参数 启用 。 当 你 使 用 hard 模式 时 ， 提 交 对 象 将 被 移 除 ， 工 作 目 录 也 将 被 更 新 ， 
那些 提交 对 象 中 储存 的 内 容 同样 会 被 移 除 。 如 有 果 你 在 重 置 你 的 工作 时 没有 使 用 - -hard 选 
项 ，Git 保留 工作 目录 中 的 内 容 不 变 ， 但 将 提交 对 象 扔 回 原点 。 这 个 效果 等 同 于 将 之 前 的 
提交 中 的 所 有 修改 都 写 进 了 一 份 巨大 的 工作 里 。 这 些 工作 正在 等 待 被 添加 并 提交 。 


reset 重建 了 分 支 顶 端 
有 段 时 间 ， 我 脑 中 一 直 以 为 reset 是 用 来 撤销 一 个 指定 提交 的 操作 。 这 个 定 
义 对 于 revert 命令 来 说 是 正确 的 ， 而 不 是 reset, reset 命令 将 当前 分 支 
的 最 新 提交 重 设 为 指定 提交 。 或 许 如 果 命 名 为 “restore (恢复 )”、“promote 
(提升 )” 或 甚至 “set( 设 为 )”， 我 的 头脑 将 能 够 更 好 地 区 分 这 两 个 命令 。 记 
f£: reset 的 对 象 是 要 保留 的 东西 ， 而 revert 的 对 象 是 要 舍弃 的 东西 。 





























继续 使 用 我 们 的 珠子 比喻 ， 假 设 你 希望 重 置 你 的 珠 串 ， 把 最 新 的 三 颗 珠 子 赫 换 成 一 颗 大 珠 
子 。 你 用 reset 命令 将 珠 串 新 的 末端 指向 距离 末端 第 四 颗 珠子 。 然 后 ， 你 将 这 三 颗 珠 子 从 
BERT, GREAT --hard 参数 ， 这 些 珠 子 将 被 丢弃 。) 相反 ， 我 们 将 要 重 塑 这 些 珠 
子 ， 然 后 将 它们 作为 一 个 新 的 提交 放 回 到 串 上 。 
提交 必须 是 连续 的 ， 并 以 最 新 的 提交 结束 
为 了 让 这 个 操作 生效 ， 你 需要 连续 地 压缩 提交 ， 直 到 最 新 的 提交 。 我 们 正在 
做 的 事 其 实 是 交互 式 变 基 的 基础 。 通 过 reset 的 这 种 使 用 方式 ， 你 将 被 限制 
在 最 新 的 几 个 提交 中 。 通 过 变 基 ， 你 将 能 够 选择 任意 范围 内 的 提交 。 






























































使 用 log 命令 ， 辨 认 你 想 要 保留 的 最 新 提交 。 这 个 提交 将 会 成 为 分 支 的 新 顶端 ， 如 下 所 示 。 


$ git log --oneline 





699d8e0 More editing second file 
eabb4cc Editing the second file 
d955e17 Adding second file 
eppb98c Editing the first file 
ee3e63c Adding first file 


还 是 回 到 我 们 的 三 个 珠子 的 比喻 ， 我 想 要 保留 的 珠子 ， 也 就 是 我 的 项 链 的 顶端 是 eppb98c。 
( 它 是 从 末端 数 第 四 颗 珠 子 ， 如 果 你 的 注意 力 完 全 集中 于 移 除 三 颗 珠 子 上 ， 可 能 不 是 那么 
符合 你 的 直觉 。) 我 们 将 手指 放 在 我 们 想 要 保留 的 珠子 上 ， 让 剩 下 的 珠子 从 串 上 请 落下 来 ， 
如 下 所 示 。 

$ git reset eppb98c 
现在 我 们 有 三 个 散落 的 珠子 四 处 乱 撞 。 这 些 珠子 在 我 们 的 仓库 中 称 为 未 跟踪 的 变更 。 文 件 
的 内 容 将 不 会 被 改变 。 
你 可 以 使 用 diff 命令 来 查看 你 的 新 提交 中 包含 的 内 容 ， 如 下 所 示 。 














$ git diff 
为 了 将 这 三 个 提交 中 做 出 的 编辑 合并 到 一 个 单独 的 提交 ， 使 用 add 命令 捕捉 暂 存 区 中 的 所 
有 变更 ， 如 下 所 示 。 

$ git add --all 
确保 这 些 文件 现在 都 被 暂 存 并 准备 好 保存 ， 如 下 所 示 。 


$ git status 


现在 这 些 文件 已 经 被 暂 存 ，diff 命令 不 再 向 你 显示 你 将 提交 到 仓库 的 内 容 。 因 此 ， 你 需要 
检验 被 暂 存 的 这 些 变更 ， 如 下 所 示 。 


$ git diff --staged 




















暂 存 也 是 一 种 缓存 

staged 参数 是 --cached 参数 的 别名 。 我 选择 使 用 别名 的 版 本 ， 因 为 它 和 我 
提 到 和 暂 存 变更 时 使 用 的 术语 更 加 契合 。 如 果 你 搜索 这 个 参数 的 更 多 资料 ， 一 
定 要 去 看 一 看 它 原本 的 参数 名 。 











一 旦 你 对 新 提交 的 内 容 感到 满意 ， 你 可 以 继续 下 一 步 ， 完 成 这 个 提交 流程 ， 如 下 所 示 。 

$ git commit -m "Replacing three small beads with this single, giant bead." 
现在 ， 这 三 个 提交 将 被 合并 成 一 个 单独 的 提交 。 
如 果 你 无 法 完全 理解 reset 这 个 词 ， 以 及 为 什么 要 回 到 目标 提交 的 前 一 个 提交 ， 我 鼓励 你 
使 用 相对 历史 记录 而 不 是 提交 ID。 例 如， 如 果 你 希望 将 你 的 分 支 中 的 三 个 提交 压缩 成 一 
个 ， 应 该 使 用 下 面 的 命令 。 

$ git reset HEAD~3 
这 个 版 本 的 命令 将 你 的 仓库 置 于 上 一 个 例子 中 的 状态 ， 不 过 指针 看 上 去 使 用 了 另 一 种 描 
述 。 两 种 方法 都 行 。 选 择 任何 一 种 你 喜欢 的 描述 。 我 个 人 认为 ， 我 想 要 重 置 的 提交 够 多 
了 ， 因 此 使 用 提交 ID 而 不 是 向 前 数 数 会 更 容易 。 
如 果 你 完成 了 本 节 中 的 所 有 例子 ， 你 现在 应 该 已 经 能 够 恢复 一 个 删除 的 文件 ， 并 将 多 个 更 
小 的 提交 合并 成 一 个 。 


6.5.3， 使 用 交互 式 变 基 修 改 提交 


变 基 这 样 的 主题 既 吸 引 了 众多 狂热 的 支持 者 ， 也 有 着 强烈 的 反对 者 。 尽 管 我 在 使 用 这 个 命 
令 时 没有 遇 到 技术 问题 ， 我 大 方 地 承认 我 不 喜欢 它 的 工作 方式 。 变 基 主要 用 于 更 改 历 史记 
录 的 记录 方式 ， 通 党 保 留 你 的 工作 目录 中 的 文件 内 容 不 变 。 若 是 被 错误 地 使 用 ， 它 可 能 会 
造成 共享 分 支 的 混乱 ， 其 中 不 同 ID 的 新 提交 对 象 储存 了 相同 的 工作 。 但 我 的 抱怨 更 多 是 
关于 这 个 想法 : 可 以 根据 你 的 喜好 随意 地 重 写 历 史记 录 。 在 软件 之 外 的 世界 里 ， 历 史记 录 


否定 主义 (https://en.wikipedia.org/wiki/Historical_revisionism_(negationism)) 是 错误 的 。 









































回 滚 、 还 原 、 重 置 和 变 基 | 101 





抛 开 这 些 抱怨 ， 变 基 是 Gi 选 定 的 模型 ， 因 此 它 与 很 多 工作 流 配合 良好 。( 我 在 合适 时 用 到 
它 ， 即 使 是 在 我 的 个 人 项 目 中 ， 没 有 外 部 团队 强制 要 求 我 这 么 做 。,) 使 用 变 基 的 一 个 合适 
的 场景 是 ， 保 持 一 个 分 支 最 新 (正如 第 3 章 和 6.2 节 中 讨论 过 的 那样 ) ， 第 二 个 场景 是 在 
发 布 工作 前 ， 交 互 式 变 基 充 许 你 将 提交 安排 成 易于 阅读 的 历史 记录 。 在 本 节 中 ， 你 将 学 到 


这 两 种 方法 中 的 后 一 种 。 





























如 果 你 一 直 都 提交 细小 的 想法 ， 那 么 交互 式 变 基 会 尤为 有 用 ， 只 在 你 的 历史 记录 中 保留 包 
含 一 部 分 想法 的 提交 。 如 果 你 有 很 多 提交 ， 因 为 同行 评审 或 是 你 自己 回头 一 想 ， 觉 得 之 前 
作出 的 决定 不 是 正确 的 方法 。 清 理 你 的 历史 记录 ， 只 保留 良好 、 有 意义 的 提交 ， 这 样 你 能 
够 更 容易 使 用 第 9 章 即将 介绍 的 bisect 命令 。 为 了 帮助 你 理解 这 个 概念 ， 我 创建 了 一 个 简 















































单 的 动画 (http://gitforteams.com/assets/animation-rebasing.svg)， 展 示 将 几 个 小 的 提交 压缩 


成 一 个 完整 的 想法 的 基本 原则 。 


你 首先 要 做 的 是 选择 项 目 中 你 想 作 为 起 点 的 一 个 提交 ，( 我 通常 选择 比 我 认为 我 需要 的 提 
交 更 早 一 个 的 提交 ， 以 防 万 一 )。 假 设 你 的 分 支 历 史记 录 中 包含 下 列 提交 。 


didc647 Revert "Adding office hours reminder." 

50605a1 Correcting joke about horses and baths. 

eed5023 Joke: What goes 'ha ha bonk'? 

77c00e2 Adding an Easter egg of bad jokes. 

0f187d8 Added information about additional people to be thanked. 
C546720 Adding office hours reminder. 

3184b5d Switching back to BADCamp version of the deck. 

bd5c178 Added feedback request; formatting updates to pro-con lists 
876e951 Removing feedback request; added Twitter handle. 


你 决定 与 笑话 相关 的 三 个 提交 应 该 被 压缩 成 一 个 单独 的 提交 。 查 看 这 个 提交 的 上 一 个 提 
交 ， 选 择 of187d8 作为 你 的 起 点 。 你 现在 已 经 准备 好 进入 变 基 的 流程 ， 如 下 所 示 。 


$ git rebase --interactive 0f187d8 

pick 77c00e2 Adding an Easter egg of bad jokes. 

pick eed5023 Joke: What goes 'ha ha bonk'? 

pick 50605a1 Correcting joke about horses and baths. 
pick didc647 Revert "Adding office hours reminder." 

















# Rebase 0f187d8..d1dc647 onto 0f187d8 


# 


# Commands: 


P, 


# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 


pick = use commit 

reword = use commit, but edit the commit message 

edit = use commit, but stop for amending 

squash = use commit, but meld into previous commit 

fixup = like "squash", but discard this commit's log message 
exec = run command (the rest of the line) using shell 


These lines can be re-ordered; they are executed from top to bottom. 
If you remove a line here THAT COMMIT WILL BE LOST. 
However, if you remove everything, the rebase will be aborted. 


Note that empty commits are commented out 
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提交 列表 被 倒序 排列 ， 最 旧 的 提交 现在 位 于 列表 的 顶端 。 编 辑 这 列表 ， 将 第 二 个 squash 5 





WERA ptck。 在 我 的 例子 中 ， 编 辑 后 的 列表 将 如 下 所 示 。 


pick 77c00e2 Adding an Easter egg of bad jokes. 

squash eed5023 Joke: What goes 'ha ha bonk'? 

squash 50605a1 Correcting joke about horses and baths. 
pick didc647 Revert "Adding office hours reminder." 








[z^ 





保存 并 退出 你 的 编辑 右 以 继续 。 提 交 消 息 的 编辑 器 将 会 在 新 窗口 中 打开 。 你 现在 需要 编写 








新 的 提交 消息 ， 表 示 所 有 你 合并 的 提交 。 你 可 以 使 用 当前 的 说 明 作为 起 点 ， 如 下 所 示 。 


# 这 是 三 个 提交 的 组 合 
# 第 一 个 提交 的 消息 如 下 所 示 
Adding an Easter egg of bad jokes. 




















You should add your bad jokes too. 




















# 第 二 个 提交 的 消息 如 下 所 示 


Joke: What goes 'ha ha bonk'? 

















# 第 三 个 提交 的 消息 如 下 所 示 





Correcting joke about horses and baths. 


Please enter the commit message for your changes. Lines starting 
with '#' will be ignored, and an empty message aborts the commit. 


Date: Wed Sep 10 06:12:01 2014 -0400 
You are currently editing a commit while rebasing branch 'practice rebasing' 
n '0f187d8'. 


Changes to be committed: 


# 

# 

# 

# 

# 

# rebase in progress; onto 0f187d8 
# 

o 

# 

# 

# new file: badjokes.md 
# 


在 我 的 例子 中 ， 更 新 后 的 提交 消息 应 该 如 下 所 示 。 


Adding an Easter egg of bad jokes. 





- New Joke: What goes 'ha ha bonk'? 
你 不 需要 移 除 以 # 开头 的 行 。 我 这 么 做 只 是 为 了 看 上 去 更 容易 阅读 一 些 。 
当 你 对 新 的 提交 消息 感到 满意 时 ， 保 存 并 退出 编辑 器 以 继续 ， 如 下 所 示 。 


[detached HEAD 1c10178] Adding an Easter egg of bad jokes. 
Date: Wed Sep 10 06:12:01 2014 -0400 

1 file changed, 7 insertions(+) 

create mode 100644 badjokes.md 

Successfully rebased and updated refs/heads/practice rebasing. 


变 基 过 程 现 已 完成 。 被 你 修订 后 的 日 志 将 会 如 下 所 示 。 

















n 


XR. 还 原 、 重 置 和 变 基 
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$ git log --oneline 


ef4409f Revert "Adding office hours reminder." 

1c10178 Adding an Easter egg of bad jokes. 

0f187d8 Added information about additional people to be thanked. 
c546720 Adding office hours reminder. 

3184b5d Switching back to BADCamp version of the deck. 


在 第 二 个 例子 中 ， 我 们 把 单独 提交 中 做 出 的 变更 拆 分 成 两 个 提交 。 如 果 你 在 一 个 文件 中 添 

加 了 多 条 修改 ， 并 在 一 个 单独 的 提交 中 提交 了 这 些 变更 ， 但 它们 事实 上 应 该 被 保存 成 两 个 

分 开 的 提交 。 

和 之 前 一 样 ， 将 一 个 提交 拆 分 成 多 个 提交 。 这 次 在 给 出 的 一 列 选 项 中 ， 将 其 中 一 个 提交 前 

的 pick 改 为 edit。 当 你 保存 并 关闭 编辑 器 时 ，Git 会 给 你 修补 提交 的 选项 (你 知道 该 怎么 

做 ! )， 然 后 继续 变 基 过 程 。 
Stopped at 0f187d831260b8e93d37bad11be1lf41aaeca835e... Added information 


about additional people to be thanked. 
You can amend the commit now, with 




















git commit --amend 
Once you are satisfied with your changes, run 


git rebase --continue 


此 时 ， 你 处 于 分 离 式 HEAD 状态 下 〈 你 已 经 遇 到 过 这 种 情况 了 ! 没事 的 ! )， 但 文件 都 被 提 
交 了 。 你 需要 重 置 工作 目录 ， 让 你 能 够 在 未 提交 的 文件 上 工作 。 你 是 否 记得 我 们 之 前 用 来 
完成 这 一 步 的 命令 ?就 是 reset! 与 其 选择 一 个 特定 提交 ， 你 也 可 以 使 用 “前 一 个 提交 ”的 
缩写 ， 也 就 是 HEAD~1， 如 下 所 示 。 


$ git reset HEAD~1 








Unstaged changes after reset: 
M README . md 


现在 ， 你 的 工作 目录 中 包含 未 提交 的 文件 ， 需 要 在 继续 变 基 前 被 添加 。 


此 时 ， 你 可 以 添加 - -patch 参数 来 交互 式 地 暂 存 你 的 文件 ， 你 可 以 将 一 个 文件 中 的 修改 拆 
分 到 两 个 〈 或 多 个 ) 提交 。 你 需要 将 一 个 补丁 片段 添加 到 暂 存 区 ， 提 交 变 更 ,然后 将 一 个 
新 的 补丁 片段 加 入 暂 存 区 ， 如 下 所 示 。 


$ git add --patch README.md 
Git 将 会 询问 你 是 否 想 要 暂 存 文件 中 的 每 一 个 补丁 片段 ， 如 下 所 示 。 


diff --git a/README.md b/README.md 

index 291915b..2eceb48 100644 

--- a/README. md 

+++ b/README.md 

QQ -49,3 +49,5 QQ Emma is grateful for the support she received while employed at 
Drupalize.Me (Lullabot) for the development of this material. 

The first version of the reveal.js slides for this work were posted at 








[workflow-git-workshop(https://github.com/DrupalizeMe/workflow-git-workshop). 
a 
*Emma is also grateful to you for watching her git tutorials! 
Stage this hunk [y,n,8,a,d,/,e,?]? 


如 果 你 想 要 加 入 这 个 补丁 片段 ， 选 择 y， 否 则 选择 n。 如 果 这 个 补丁 片段 过 大 ， 你 只 希望 
加 入 其 中 部 分 片段 ， 选 择 s (这 个 选项 在 补丁 片段 过 小 时 不 会 出 现 )。 浏 览 文件 中 的 每 个 修 
改 ， 选 择 合适 的 选项 。 当 你 到 达 变 更 列表 的 底部 时 ， 你 将 会 回 到 命令 行 。 使 用 git status 
命令 ,假设 有 多 个 补丁 片段 需要 修改 ， 你 将 会 看 到 你 的 文件 准备 好 被 提交 且 没 有 被 暂 存 ， 
如 下 所 示 。 

$ git status 

rebase in progress; onto bd5c178 

You are currently splitting a commit while rebasing branch 'practice rebasing' 


on 'bd5c178'. 
(Once your working directory is clean, run "git rebase --continue") 






































Changes to be committed: 
(use "git reset HEAD «file»... 


to unstage) 
modified: ^ README.md 


Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout -- <file>..." to discard changes in working directory) 


modified: README . md 


提交 你 暂 存 的 变更 以 继续 ， 如 下 所 示 。 

$ git commit 
如 果 剩 下 的 变更 可 以 包含 在 同一 个 提交 中 ， 你 可 以 忽略 - patch 参数 ， 添 加 文件 并 将 文件 
提交 至 仓库 ， 如 下 所 示 。 


$ git add README.md 
$ git commit 


提交 了 所 有 变更 后 ， 你 准备 继续 变 基 。 似 乎 没有 任何 提示 ， 但 如 果 你 去 检查 状态 ，Git 将 
会 提醒 你 变 基 还 设 有 结束 ， 如 下 所 示 。 


$ git status 


























rebase in progress; onto bd5c178 
You are currently editing a commit while rebasing branch 'practice rebasing' 
on 'bd5c178'. 

(use "git commit --amend" to amend the current commit) 

(use "git rebase --continue" once you are satisfied with your changes) 


nothing to commit, working directory clean 


为 了 完成 变 基 ， 使 用 Git 在 状态 消息 中 给 出 的 命令 ， 如 下 所 示 。 


$ git rebase --continue 
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Successfully rebased and updated refs/heads/practice rebasing. 


终于 搞定 了 ! 中 间 有 很 多 步骤 ， 但 你 之 前 已 经 党 试 过 了 这 些 概念 ， 这 次 它们 被 串 在 了 一 
起 。 干 得 漂亮 ! 

如 果 你 完成 了 本 市 中 的 所 有 例子 ， 你 现在 应 该 能 够 修补 提交 ， 使 用 交互 式 变 基 更 改 分 支 的 
历史 记录 。 


6.5.4 撤销 分 支 合并 


当 你 在 合并 分 支 时 ， 你 可 能 出 现 差错 。 或 许 你 在 执行 合并 时 签 出 了 错误 的 分 支 ， 或 许 你 本 
应 该 使 用 --no-ff 参数 来 执行 合并 却 忘 了 这 么 做 。 只 要 你 还 没有 发 布 这 个 分 支 ,，“ 撤 销 合 
并 ”(unmerge) 你 的 分 支 将 会 非常 容易 。 
没有 所 谓 的 “撤销 合并 ” 
“不 可 思议 ”， 他 喊 道 ,“ 我 不 觉得 这 个 词 是 你 说 的 这 个 意思 ”， 其 他 人 补充 
道 。 类 比 《 公 主 新 娘 》， 这 是 真 的 ，Git 中 没有 所 谓 的 六 指 人 ， 也 没有 一 种 
方法 可 以 “撤销 合并 ”什么 分 支 。 但 是 ， 你 可 以 将 分 支 顶端 重 置 为 你 使 用 
merge 命令 前 的 那 一 个 提交 ， 从 而 反 转 合并 产生 的 影响 。 和 希望 你 不 会 经 党 遇 
到 这 种 情况 ， 因 为 这 个 过 程 可 能 会 耗费 你 大 量 的 时 间 。 




















AH 


蛙 想 情况 下 ， 在 错误 地 合并 一 个 分 支 后 ， 你 将 会 立即 意识 到 这 个 错误 。 这 是 反 转 最 常见 的 
场景 。Git 知道 有 一 些 命令 相对 更 加 危险 ， 因 此 它 在 执行 这 些 危险 的 操作 前 保存 了 一 个 指 
向 最 新 提交 的 指针 。Git 认为 合并 是 危险 的 ， 因 此 你 可 以 通过 运行 reset 轻而易举 地 取消 一 
个 合并 ， 并 将 你 的 分 支 顶端 重新 指向 合并 发 生前 的 那个 提交 ， 如 下 所 示 。 


$ git reset --merge ORIG HEAD 


如 果 你 没有 立即 意识 到 你 的 错误 ， 你 需要 在 继续 前 问 自 己 儿 个 问题 。 图 6-6 总 结 了 你 在 选 
择 正 确 的 命令 来 撤销 合并 工作 前 ， 需 要 进行 的 思 
你 需要 仔细 思考 在 继续 前 你 想 要 保留 什么 工作 ， 以 及 想 要 侈 弃 什 么 操作 。 如 果 你 已 经 删除 
了 一 个 分 支 ， 你 或 许 希 望 在 另 一 个 分 支 中 建立 一 份 这 些 提 交 的 备份 。 这 样 你 就 不 需要 研究 
引用 日 志 来 找到 丢失 的 提交 。 

假设 你 正在 master 分 支 上 工作 ， 你 希望 创建 一 个 名 为 preservation branch 的 备份 分 支 ， 
如 下 所 示 。 


$ git checkout master 





























M 














$ git checkout -b preservation branch 


















在 出 错 的 合并 后 ， 
当前 分 支 上 是 否 存 
在 后 续 提交 ? 





另 一 个 分 支 是 


否 已 被 删除 ? 





2i 


reset --merge ORIG. HEAD reset «ast. correct. commit» 


merge «branch with good commits? 





你 是 否 想 要 重 
试 合 并 ? 
















Checkout «commit before bad merge» 
checkout -b safe. branch 
Cherry-pick «commit to save? 


died bate. branch checkout <branch_to_fix> 


heckout «branch to fix» "E 


图 6-6: 在 取消 合并 分 支 前 ， 思 考 如 何 找 回 丢失 的 提交 


现在 ， 你 的 这 个 分 支 既 包含 想 要 的 提交 ， 也 包含 不 想 要 的 提交 ， 你 可 以 通过 移 除 不 想 要 的 
提交 来 进入 下 一 步 。 我 们 假设 你 没有 其 他 想 要 保存 在 这 个 分 支 上 的 提交 ， 如 下 所 示 。 


$ git checkout master 
$ git reset --merge ORIG_HEAD 


如 果 你 确实 希望 保存 一 些 提 交 ， 现 在 就 可 以 将 这 些 提交 从 刚 创建 的 备份 分 支 中 cherry- 
pick 〈 拣 选 ) 过 来 ， 如 下 所 示 。 

$ git cherry-pick commit to restore 
只 有 当 你 意识 到 要 撤销 合并 一 个 出 错 的 分 支 时 ， 使 用 ORIG HEAD 参照 点 的 做 法 才能 生效 。 
如 果 你 进行 了 其 他 工作 ， 有 可 能 Git 已 经 建立 了 一 个 新 的 ORIG_HEAD。 在 这 种 情况 下 ， 你 需 
要 选择 想 要 回 退 到 的 提交 ID ， 如 下 所 示 。 

$ git reset last correct commit 
正如 图 6-6 所 示 ， 还 有 一 些 其 他 需要 撤销 合并 分 支 的 场景 。 慢 慢 了 解 ， 记 住 引用 日 志 跟 踪 
了 你 的 所 有 操作 ， 即 使 你 丢失 了 什么 东西 ， 你 总 是 可 以 回 到 过 去 ， 签 出 一 个 特定 的 提交 ， 
然后 思考 怎么 做 才 不 会 丢失 任何 工作 。 
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6.6 ”撤销 共享 历史 记录 


本 章 之 前 的 部 分 一 直 集 中 于 改变 仓库 中 未 发 布 的 历史 记录 。 在 你 开始 发 布 你 的 工作 之 后 ， 
你 难免 有 时 候 会 不 小 心 发 布 需要 修补 的 工作 。 有 很 多 原因 可 以 解释 这 一 点 ， 可 能 是 因为 来 
自 客户 的 新 需求 、 因 为 你 发 现 了 bug 或 是 因为 其 他 人 发 现 了 bug。 如 果 你 要 和 别人 共享 你 
的 修改 ， 没 有 什么 可 感到 羞愧 的 ， 你 完全 不 必 掩 饰 自己 的 学 习 过 程 ! 不 过 ， 有 了 时 你 应 该 清 
下 已 经 共享 的 提交 历史 记录 。 例 如 ， 过 多 的 次 要 修改 会 使 得 bisect 这 样 的 调试 工具 性 
能 下 降 ， 而 且 干 净 的 提交 历史 记录 更 加 易于 阅读 。 修 改 共享 历 史记 录 最 好 的 方式 是 完全 不 
要 修改 。 与 其 说 是 “ 回 滚 ” 到 一 个 过 去 的 可 用 状态 ， 你 应 该 将 这 个 操作 视 为 “前 深 ” 到 一 
个 未 来 的 可 用 状态 。 你 可 以 通过 添加 新 的 提交 来 完成 这 个 操作 ， 或 者 使 用 revert 命令 。 在 
本 市 中 ， 你 将 会 学 到 如 何 修补 共享 的 历史 记录 ， 而 不 使 你 的 队友 感到 困惑 。 


6.6.1 还 原 之 前 的 提交 

如 果 你 在 过 去 有 一 个 错误 的 提交 ， 你 完全 可 以 使 用 revert (还 原 ) 命令 ， 用 一 个 新 的 提交 
恰好 抵消 之 前 的 提交 。 如 果 从 物理 学 的 角度 讲 ，revert 有 点 像 是 降 噪 耳 机 。 这 个 命令 发 出 
和 背景 噪声 完全 相反 的 声音 ， 事 实 上 你 听 到 的 就 是 一 片 安静 。 


当 你 使 用 revert 命令 时 ， 你 将 会 注意 到 你 的 项 目 历史 记录 没有 被 改变 。 提 交 没 有 被 移 除 ， 
而 分 支 顶端 出 现 了 一 个 新 的 提交 。 例 如 ， 如 有 果 你 想 要 还 原 新 增 的 三 个 空 行 和 删除 的 一 行 ， 
还 原 操作 将 会 移 除 这 三 行 并 加 回 被 删除 的 一 行 。 
例如 ， 你 的 分 支 历史 记录 如 下 所 示 。 

50605a1 Correcting joke about horses and baths. 

eed5023 Joke: What goes 'ha ha bonk'? 

77c00e2 Adding an Easter egg of bad jokes. 

0f187d8 Added information about additional people to be thanked. 

c546720 Adding office hours reminder. 


3184b5d Switching back to BADCamp version of the deck. 
bd5c178 Added feedback request; formatting updates to pro-con lists 


你 决定 要 移 除 关 于 办 公 时 间 提 醒 的 提交 ， 因 为 此 消息 只 在 过 去 有 意义 。 此 消息 被 添加 在 
c546720 位 置 ， 如 下 所 示 。 

$ git revert c546720 
提交 消息 的 编辑 器 将 会 打开 。 屏 幕 上 显示 了 默认 的 提交 消息 ， 你 可 以 保存 并 退出 以 继续 下 
一 步 ， 如 下 所 示 。 


[master didc647] Revert "Adding office hours reminder." 
1 file changed, 2 deletions(-) 


现在 ， 你 记录 的 历史 记录 中 包含 了 一 个 新 的 提交 ， 用 于 撤销 添加 至 c546729 中 的 更 改 ， 如 
下 所 示 。 
didc647 Revert "Adding office hours reminder." 


50605a1 Correcting joke about horses and baths. 
eed5023 Joke: What goes 'ha ha bonk'? 

































































n 
"m 











D 








N 


















































77c00e2 Adding an Easter egg of bad jokes. 

0f187d8 Added information about additional people to be thanked. 
C546720 Adding office hours reminder. 

3184b5d Switching back to BADCamp version of the deck. 


对 每 个 想 要 还 原 的 提交 执行 相同 的 操作 。 
如 果 你 完成 了 本 节 中 的 所 有 练习 ， 你 现在 应 该 已 经 可 以 还 原 之 前 已 完成 的 提交 中 的 变更 。 


6.6.2 ”撤销 共享 分 支 的 合并 

在 本 章 之 前 的 部 分 中 ， 你 已 经 学 会 了 通过 reset 命令 撤销 两 个 分 支 的 合并 。 这 个 命令 删除 
了 分 支 历 史记 录 上 的 提交 。 因 此 ，Git 再 次 遇 到 这 些 提交 时 ， 会 把 它们 视 为 新 的 提交 。 当 
尔 将 一 个 (过 时 的 ) 分 支 并 入 主 仓库 时 ， 你 就 会 遇 到 这 种 情况 。 

为 了 决定 使 用 哪个 命令 ， 你 需要 首先 确定 你 要 处 理 的 是 哪 种 合并 。 图 6-7 将 快 进 合 并 与 真 
正 的 合并 进行 了 比较 。 快 进 合并 基于 源 分 支 〈 即 将 被 并 和 的 分 支 ) 上 的 提交 ， 而 真正 的 合 
并 显示 为 图 上 的 凹 起 ， 在 合并 发 生 处 引入 了 一 个 新 的 提交 。 

使 用 tog 命令 ， 查 看 错误 的 分 支 被 并 入 了 哪个 节点 〈 例 6-8)。 如 果 存 在 合并 提交 ， 那 你 就 
走运 了 ! 如 果 没 有 合并 提交 ， 你 需要 完成 更 多 的 工作 来 撤销 分 支 合并 。 


例 6-8 提交 历史 记录 中 的 图 形 化 日 志 会 告诉 你 是 否 是 真正 的 合并 


$ git log --oneline --graph 
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4f2eaa4 Merge branch 'ch07' into drafts 
\ 
ci0fbdd CH07: snapshot after editing draft in LibreOffice 
9716e7b CH07: snapshot before LibreOffice editing 
8373ad7 App01: moving version check to the appendix from CH07 
d602e51 CH7: Stub file added with notes copied from video recording lessons. 
1ae7de0 CH08: Incorrect heading formatting was creating new chapter 
7907650 CH08: Draft chapter. Based on ALA article. 


* 
| 
| 
| 
| 
| 
* 
* 
* | ad6c422 CH8: Stub file added with notes copied from video recording lessons. 


— — — cook o Ro i 


如 果 你 希望 查看 某 个 单独 的 提交 是 否 是 一 次 真正 的 合并 ， 你 可 以 使 用 show 命令 。 这 个 命令 
将 会 列 出 所 有 合并 的 分 支 的 SHA1， 如 下 所 示 。 


$ git show 90249389 











commit 902493896b794d7bc6b19a1130240302efb1757f 
Merge: 54a4fdf c077a62 

Author: Joe Shindelar «redacted(jgmail.com» 
Date: Mon Jan 26 18:30:55 2015 -0700 


Merge branch 'dev' into qa 


谢谢 你 的 建议 ，Joe ! 
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要 被 合并 的 分 支 





“正在 接收 合并 ”的 (GE) 分 支 | 








额外 的 提交 将 会 
阻止 快 进 合 并 








真正 的 合并 快 进 合 并 
(不 需要 变 基 ) 性 要 先 恋 基 ) 














变 基 后 ， 现 在 分 
支 可 以 进行 快 进 














( 非 快 进 ) 











图 6-7. 如 图 所 见 ， 快 进 合并 丢失 了 分 支 原 本 的 面貌 ， 真 正 的 合并 保留 了 这 个 面貌 
保持 一 致 ， 方 便 搜 索 


合并 提交 默认 的 提交 消息 是 “Merge branch incoming into current”(“ 将 某 个 


分 支 并 入 当前 分 支 ") ， 当 你 在 查看 log 命令 的 输出 时 你 将 更 容易 找到 合并 提 
交 。 你 的 团队 可 能 选择 使 用 不 同 的 提交 消息 模板 但是， 你 可 以 添加 可 选 的 
--nerges 和 - -no-nerges 参数 来 过 滤 输 出 的 历史 记录 。 




















一 旦 你 找到 了 一 个 合并 提交 ， 你 就 可 以 选择 一 组 合适 的 命令 。 图 6-8 将 这 些 选 项 总 结 成 一 
张 流 程 图 。 




















P 


revert --mainline N <commit> 

一 般 来 说 N=1。 

查看 gtlg -a lin --gah 。 从 左 
到 右 清 点 泳 道 数量 获得 N。 必 须 是 
一 个 合并 提交 。 


branch --contains «commit 





revert «commit? 
对 每 个 错误 的 提交 重复 此 操作 。 








revert --no-commit «commit Kkeep-..«commit reject 
add «filename(s)7 
commit 








图 6-8: 根据 分 支 的 合并 方式 ， 你 将 会 使 用 不 同 的 命令 来 撤销 共享 分 支 的 合并 


如 果 分 支 被 真正 地 合并 了 ， 而 不 是 快 进 合并 ， 那 么 撤销 的 流程 如 下 : 使 用 revert 命令 反 转 
合并 提交 的 作用 ( 例 6-9)。 这 个 命令 接受 一 个 额外 的 参数 --mainline。 这 个 参数 告诉 Git 
在 撤销 这 次 合并 时 应 该 保留 哪个 分 支 。 仔 细 观 察 图形 化 的 日 志 ， 数 一 数 从 左 到 左 的 六 道 。 
第 一 个 泳 道 为 1。 你 几乎 总 是 希望 留 在 最 左边 的 泳 道 ， 因 此 因此 这 个 数字 几乎 也 总 是 1。 


例 6-9 反 转 一 个 合并 提交 

$ git checkout branch to clean up 

$ git log --graph --oneline 

$ git revert --mainline 1 4f2eaa4 
提交 消息 的 编辑 器 将 会 打开 。 默 认 的 提交 消息 指出 你 刚 执行 了 一 次 还 原 操作 ， 并 提供 了 你 
撤销 的 那个 提交 的 提交 消息 ( 例 6-10)。 我 一 般 偷 懒 保留 这 个 说 明 ， 但是， 这 样 做 也 有 好 
处 ， 当 我 搜索 历史 记录 时 找到 反 转 合并 的 那个 提交 将 会 非常 容易 。 


例 6-10: 还 原 合并 提交 的 提交 消息 示意 
Revert "Merge branch 'video-lessons' into integration test" 



































This reverts commit 0075f7eda67326f174623eca9ec09fd54d7f4b74, reversing 
changes made to 0f1874d831260b8e93d37bad11beif41aaeca835e. 


# Please enter the commit message for your changes. Lines starting 
4 with '#' will be ignored, and an empty message aborts the commit. 
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n 














# On branch master 

# Your branch and 'origin/master' have diverged, 

it and have 23 and 2 different commits each, respectively. 
# (use "git pull" to merge the remote branch into yours) 


(D 

ct 

n 
— 


# 

# Changes to be committed: 

# deleted: lessons/01-intro/README.md 

# deleted: lessons/02-getting-started/README.md 
# deleted: lessons/03-clone-remote/README. md 

i deleted: lessons/04-config/README.md 

( 

# 








有 时 ， 当 你 运行 revert HABAR., A Tok. RRE EAEE PEKAJ 
遵循 Git 在 屏幕 上 输出 的 指示 ， 如 下 所 示 。 


$ git revert --mainline 1 a1173fd 





error: could not revert a1173fd... Merge branch 'unmerging' 
hint: after resolving the conflicts, mark the corrected paths 
hint: with 'git add «paths»' or 'git rm «paths»' 

hint: and commit the result with 'git commit' 

Resolved 'README.md' using previous resolution. 


出 了 点 问题 ， 请 检查 状态 消息 ， 看 看 我 们 需要 审查 哪些 文件 ， 如 下 所 示 。 


$ git status 





On branch master 
Your branch and 'origin/master' have diverged, 
and have 20 and 2 different commits each, respectively. 
(use "git pull" to merge the remote branch into yours) 
You are currently reverting commit a1173fd. 
(fix conflicts and run "git revert --continue") 
(use "git revert --abort" to cancel the revert operation) 


Changes to be committed: 
(use "git reset HEAD «file»... 


to unstage) 


deleted: badjokes.md 
modified: | slides/slides/session-oscon.html 


Unmerged paths: 
(use "git reset HEAD <file>..." to unstage) 
(use "git add <file>..." to mark resolution) 


both modified: README .md 
状态 消息 中 提 到 仓库 与 origiin 不 同步 ， 这 与 我 们 的 问题 无 关 。 跳 过 这 条 ， 继 续 阅 
个 有 用 的 信息 从 这 里 开始 : You are currently reverting (您 在 执行 反 转 操作 )。 你 
何 继续 的 选项 以 及 如 何 中 断 这 个 过 程 的 选项 。 不 要 放弃 ! 继续 读 下 去 。 接 下 来 几 
像 是 平常 混杂 的 工作 目录 ， 其 中 一 些 文件 被 暂 存 了 ， 而 另 一 些 没 有 。 如 果 你 只 是 





























读 。 第 一 
会 看 到 如 
行 看 上 去 
在 编辑 你 


自己 的 文件 ， 你 会 知道 如 何 处 理 。 首 先 ， 将 你 的 修改 添加 到 暂 存 区 ， 然 后 提交 ， 如 下 所 示 。 
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$ git add README.md 
$ git commit -m "Reversing the merge commit a1173fd." 


[naster 291dabe] Reversing the merge commit a1173fd. 
2 files changed, 2 insertions(+), 7 deletions(-) 
delete mode 100644 badjokes.md 


如 果 设 有 合并 提交 ， 你 需要 一 个 个 处 理 每 个 你 想 要 撤销 的 提交 。 这 个 过 程 将 会 尤其 令 人 浊 
夹 ， 因 为 快 进 合并 在 图 形 化 日 志 中 没有 提供 任何 可 视 化 的 线索 ， 告 诉 你 那个 烦人 的 分 支 中 
有 哪些 提交 。( 在 第 一 次 撤销 拣选 错误 的 合并 后 ， 你 将 会 理解 合并 分 支 时 看 到 的 --no-ff 策 
略 的 逻辑 。) 




















和 你 的 团队 讨论 应 该 怎么 做 

在 一 个 个 撤销 拣选 这 些 提 交 前 ， 你 可 能 想 看 看 团队 中 有 谁 有 尚未 发 布 且 未 被 
污染 的 分 支 ， 让 他 们 共享 这 个 分 支 。 有 时 ， 小 心地 使 用 push --force 可 以 
更 容易 地 改变 历史 记录 。 

















你 需要 做 的 第 一 件 事 是 猜测 出 错 的 提交 在 哪 。 如 果 你 完全 确定 哪里 出 错 了 ， 那 么 可 以 通过 
使 用 --contains 参数 的 branch 命令 来 列 出 包含 某 个 提交 的 所 有 分 支 ， 如 下 所 示 。 

$ git branch --contains commit 
假设 被 并 入 的 那个 分 支 没有 被 删除 ， 那 么 你 应 该 能 够 使 用 这 些 信息 来 判断 你 要 撤销 合并 哪 
个 分 支 ， 以 及 哪些 提交 被 添加 到 你 或 许 想 要 移 除 的 分 支 。 但 是 ， 记 住 ， 这 些 提交 同时 出 现 
在 了 两 个 分 支 中 ， 因 此 你 无 法 通过 比较 来 找 出 哪些 提交 是 不 同 的 。 如 果 你 已 经 知道 你 想 要 
找 的 提交 ， 你 不 必 完 成 这 一 步 。 
如 果 你 想 要 还 原 的 提交 是 连续 的 ， 你 太 走 运 了 ! revert 命令 可 以 接受 单个 提交 ， 或 是 一 系 
列 提交 。 但 是 ， 记 住 ，revert 将 会 为 每 个 反 转 的 提交 创建 一 个 新 的 提交 。 在 你 的 提交 历史 
记录 中 ， 这 些 提 交 看 上 去 可 能 非常 讨厌 ， 因 此 与 其 单独 反 转 每 个 提交 ， 你 可 以 选择 将 这 些 
提交 组 合成 一 次 反 转 ， 最 后 再 保存 提交 消息 ， 如 下 所 示 。 

$ git revert --no-commit [ast commit to keep..newest commit to reject 
在 运行 这 个 命令 后 ， 你 将 会 得 到 一 个 混乱 的 工作 目录 ， 所 有 文件 都 被 还 原 。 审 查 这 些 变 
更 。 然 后 ， 完 成 还 原 过 程 ， 如 下 所 示 。 

$ git revert --continue 
审查 提交 消息 ， 补 充 必要 的 信息 来 使 之 更 清晰 。 在 默认 情况 下 ， 这 个 说 明 将 会 以 “Revert” 
开头 ， 接 着 是 一 串 带 引 号 的 文字 ， 描 述 你 正在 反 转 的 最 新 提交 中 的 内 容 。 通 常 这 样 就 足够 
了 ， 但 如 果 原 来 的 说 明 不 够 好 ， 你 可 能 会 希望 让 描述 更 加 清晰 一 些 。 
如 果 提 交 不 连续 ， 你 需要 一 次 一 个 地 还 原 这 些 恼 人 的 提交 。 给 我 发 条 推 文 ， 提 到 @emmajanehw， 
我 会 给 你 一 些 安奈 并 给 你 鼓掌 。 


$ git revert commit 


除非 特定 的 工作 流 要 求 ， 撤 销 合 并 一 个 已 合并 的 分 支 不 是 Git 希望 看 到 的 事 。 你 的 团队 可 
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能 永远 用 不 到 撤销 合并 一 个 分 支 。 显 然 ， 在 我 的 个 人 项 目 中 有 时 会 遇 到 错误 的 合并 ， 作 为 
独立 开发 者 ， 我 已 经 习惯 了 暗自 悲伤 一 会 ， 然 后 将 烦恼 抛 在 脑 后 。 有 时 历史 记录 并 设 有 那 
么 重要 ， 而 有 些 时 候 确 实 很 重要 。 有 了 经 验 和 教训 ， 你 对 本 该 使 用 什么 命令 了 然 于 心 。 


6.7 真正 移 除 历史 记录 


在 本 章 中 ， 你 已 经 学 到 了 更 新 仓库 历史 记录 ， 尤 其 是 如 何在 你 认为 工作 丢失 时 获取 信息 。 
有 时 ， 或 许 你 真 的 想 要 丢掉 部 分 历史 记录 一 一 例如 ， 如 果 你 不 小 心 提交 了 一 份 很 大 的 数据 
文件 或 者 一 份 包含 密码 的 配置 文件 。 希 望 你 永远 用 不 到 这 一 市 中 的 内 容 ， 但 以 防 万 一 你 的 
“朋友 ”需要 帮助 呢 ， 我 加 入 了 这 些 指南 。 你 懂得 ， 不 怕 一 万 ， 就 怕 万 一 。 

发 布 后 的 历史 记录 是 公开 的 

如 果 你 将 一 些 内 容 发 布 到 一 个 公开 的 远程 仓库 ， 你 应 该 做 好 这 样 的 准备 ， 其 
他 人 可 能 会 上 去 克隆 一 份 仓 库 的 副本 ， 并 且 访 问 到 你 不 打算 公开 的 秘密 。 立 
刻 更 新 在 这 个 仓库 中 公开 过 的 密码 和 API 251, 









































如 有 果 你 需要 在 已 发 布 的 分 支 上 清理 一 些 东 西 ， 你 应 该 在 第 一 时 间 通 知 你 的 队友 。 你 应 该 让 
他 们 知道 你 将 要 进行 一 些 清理 ， 并 且 将 向 仓库 “强制 推送 ”一 份 新 的 历史 记录 。 开 发 者 需 
要 重新 评估 他 们 的 本 地 仓库 ， 并 决定 他 们 所 处 的 状态 。 让 每 个 开发 者 都 找 一 找 冲突 的 文 
件 ， 看 看 他 们 的 仓库 是 否 被 污染 了 ， 操 作 步 又 如 下 所 示 。 


。 如 果 你 尝试 移 除 的 文件 不 在 他 们 的 本 地 仓库 中 ， 他 们 不 会 被 你 的 清理 所 影响 。 

。 如 果 他 们 的 仓库 中 的 每 个 分 支 都 包含 这 份 文件 ， 那 么 他 们 的 仓库 就 被 污染 了 。 但 是 ， 如 
有 果 他 们 在 这 份 文件 被 引入 前 没有 开始 任何 工作 ， 他 们 不 会 被 你 的 清理 所 影响 。 这 一 点 对 
于 不 是 本 地 开发 者 的 QA 管理 者 来 说 也 成 立 。 在 这 种 情况 下 ， 让 他 们 移 除 自己 本 地 的 仓 

库 副本 ， 并 在 清理 完成 后 重新 克隆 仓库 。 

。 如 果 他 们 的 仓库 被 污染 了 ， 并 且 包 含 被 污染 历史 记录 的 分 支 上 包含 他 们 本 地 的 工作 ， 他 
们 需要 通过 变 基 更 新 这 些 分 支 。 如 果 他 们 使 用 merge 来 更 新 他 们 的 分 支 ， 他 们 会 再 次 将 
有 问题 的 文件 引入 仓库 ， 而 你 的 工作 也 将 前 功 尽 弃 。 对 于 不 熟悉 变 基 的 人 来 说 这 会 有 些 
可 怕 ， 因 此 你 应 该 建议 他 们 将 包含 需要 保存 的 工作 的 分 支 推 送 上 去 ， 这 样 你 可 以 帮 他 们 
清理 这 些 分 支 。( 在 清理 完成 后 让 他 们 克隆 一 份 新 的 仓库 。) 


在 你 进行 清理 时 ， 你 的 同事 们 可 以 做 些 别 的 事 (https://xkcd.com/303/)。 
当 
H 




































































团队 中 每 个 人 都 收 到 通知 ， 并 且 你 准备 好 了 一 份 计 划 ， 应 对 清理 其 他 每 个 人 的 仓库 在 清 
之 前 、 当 中 及 之 后 将 会 发 生 的 事 ， 你 可 以 继续 下 去 了 。 

为 了 完成 这 个 过 程 ， 你 可 以 使 用 filter-branch。 这 个 命令 允许 你 重 写 分 支 历 史记 录 和 标 
4k. Git 文档 中 提供 的 例子 十 分 有 趣 ， 值 得 阅读 。 例 如 ， 你 可 以 使 用 这 个 命令 来 永久 移 除 
某 个 作者 提交 的 任何 代码 。 我 不 认为 我 会 不 评估 影响 就 移 除 别人 的 代码 ， 但 有 趣 的 是 这 个 
命令 确实 可 以 这 么 使 用 。( 不 过 ， 或 许 你 恰好 知道 应 该 如 何 利 用 这 个 命令 ? ) 

假设 你 想 要 移 除 的 文件 是 SECRET.md， 命令 如 下 所 示 (这 是 一 个 很 长 的 命令 ，\ 符号 允许 
你 换 到 第 二 行 )。 
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$ git filter-branch --index-filter V 
'git rm --cache --ignore-unmatch SECRET.md' HEAD 


在 文件 从 仓库 中 完全 移 除 后 ， 将 它 加 入 你 的 .gitignore 文件 ， 这 样 它们 就 不 会 被 再 次 意外 地 
添加 了 。 使 用 .gitignore 的 指南 可 以 在 附录 C 中 找到 。 

与 本 章 中 的 其 他 方法 不 同 ， 现 在 我 们 希望 永久 地 从 仓库 中 移 除 一 些 冲 突 的 内 容 。 首 先 ， 这 
些 提 交 仍 然 可 以 通过 reflog 命令 找到 。 当 你 确定 不 再 需要 这 些 提 交 之 后 ， 可 以 通过 清除 本 
地 历史 记录 并 执行 一 次 垃圾 回收 (gc) ， 将 这 些 提交 从 你 的 系统 中 丢弃 ， 如 下 所 示 。 


$ git reflog expire --expire=now --all 
$ git gc --prune-now 


你 的 仓库 现 已 清理 完成 ， 你 可 以 将 新 版 本 推送 到 你 的 远程 仓库 ， 如 下 所 示 。 
$ git push origin --force --all --tags 
一 旦 项 目 新 版 本 的 历史 记录 可 以 从 共享 仓库 中 访问 到 ， 你 可 以 让 你 的 同事 们 更 新 他 们 的 工 
作 。 根 据 你 之 前 的 对 话 ， 他 们 会 通过 以 下 方法 来 并 入 你 处 理 过 的 变更 。 
。 再 次 从 零 克 隆 一 份 仓 库 。 这 个 方法 适合 不 使 用 变 基 并 对 它 感 到 旦 惧 的 团队 。 
。 使 用 rebase 更 新 他 们 的 分 支 。 这 个 方法 适合 熟悉 变 基 的 团队 ， 因 为 这 比重 新 克隆 一 份 
仓库 要 快 ， 并 且 能 够 保留 他 们 本 地 的 工作 ， 如 下 所 示 。 


$ git pull --rebase-preserve 





































































































GitHub (https://help.github.com/articles/remove-sensitive-data/) 和 Bitbucket (https:// 
confluence.atlassian.com/display/BITBUCKET/Maintaininga-Git-Repository) 都 提供 了 文章 
来 说 明 如 何 清 理 存放 在 它们 网 站 上 的 仓库 。 由 于 这 两 个 网 站 涉及 的 场景 略 有 不 同 ， 两 篇 文 
章 都 值得 一 读 。 

现在 ， 你 已 经 了 解 了 Git 自身 清理 仓库 的 方式 ， 查 看 这 个 单独 的 包 ，BFG Repo Cleaner 
(https://rtyley.github.io/bfg-repo-cleaner/)。 它 提供 了 和 filter-branch 相同 的 结果 ， 但 使 用 
起 来 更 加 快速 ， 而 且 在 安装 之 后 更 加 易于 使 用 。 如 果 你 对 filter-branch 所 需要 的 清理 时 
长 不 满意 ， 你 绝对 应 该 试 一 试 BFG。 


6.8 ”命令 指南 
dt 62 列 出 了 本 章 提 到 的 所 有 命令 。 
表 6-2， 撤销 工作 需要 的 git 命 令 



























































命令 Ri 

git checkout -b branch 创建 一 个 名 为 branch 的 分 支 

git add filenane(s) 暂 存 文件 ， 准 备 提交 至 仓库 

git commit 将 暂 存 的 变更 保存 至 仓库 

git checkout branch 切换 到 指定 分 支 

git merge branch 将 branch 中 的 提交 并 入 当前 分 支 
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命令 HR 
git branch --delete 移 除 本 地 分 支 


git branch -D 

git clone URL 

git log 

git reflog 

git checkout commit 

git cherry-pick commit 

git reset --merge ORIG HEAD 
git checkout -- fi lename 

git reset HEAD filename 

git reset --hard HEAD 

git reset commit 

git rebase --interactive commit 
git rebase --continue 


git revert commit 


git log --oneline --graph 
git revert --mainline 1 commit 


git branch --contains commit 


git revert --no-commit last commit to keep.. 


newest commit to reject 
git filter-branch 
git reflog expire 


git gc --prune-now 


6.9 小结 











移 除 不 包含 并 入 其 他 分 支 的 提交 的 本 地 分 支 
下 载 一 份 远 程 仓库 的 副本 
查看 项 目 历史 记录 
查看 分 支 的 详细 历史 记录 

切换 到 另 一 个 本 地 分 支 

将 提交 从 一 个 分 支 复制 到 另 一 个 分 支 

移 除 当前 分 支 中 所 有 在 最 近 一 次 合并 中 引入 的 提交 
还 原 已 变更 但 尚未 提交 的 文件 

从 暂 存 区 移 除 提出 的 文件 修改 

将 所 有 已 变更 的 文件 还 原 到 之 前 保存 的 状态 

取消 暂 存 在 这 个 提交 之 前 的 所 有 提交 中 的 变更 

编辑 ， 或 压缩 提交 后 的 所 有 提交 

在 解决 合并 冲突 后 ， 继 续 变 基 过 程 

取消 应 用 指定 提交 中 的 变更 ， 创 建 一 个 共享 友好 的 历 
史记 录 还 原 
显示 分 支 的 图 形 化 历史 记录 

反 转 一 个 合并 提交 

列 出 所 有 包含 指定 提交 对 象 的 分 文 

使 用 一 个 提交 反 转 一 组 提交 ， 而 不 是 为 每 个 撤销 的 提 
交 都 创建 一 个 对 象 

从 仓库 中 永久 移 除 文件 

忽略 详细 历史 记录 ， 仅 使 用 存储 的 提交 消息 

运行 垃圾 回收 器 并 确保 所 有 未 提交 的 变更 从 本 地 内 存 
中 移 除 





































































































在 本 章 中 ， 你 学 到 了 如 何 与 Git 仓库 历史 记录 打交道 。 我 们 介绍 了 Git 中 一 些 通常 被 新 手 
视 为 “高 级 ”的 命令 的 常见 应 用 场景 。 通 过 画图 总 结 你 的 仓库 状态 和 你 想 要 做 出 的 变动 ， 
你 可 以 有 效 地 选择 每 种 场景 下 要 允许 的 正确 Git 命令 。 你 学 会 了 如 何 使 用 Git 的 三 个 “R”。 





。 Reset (€ €) 

















将 分 支 顶 端 移 至 一 个 之 前 的 提交 。 这 个 命令 不 要 求 提 交 消 息 ， 如 果 没 有 使 用 --hard 参 


数 可 能 返回 一 个 混杂 的 仓库 。 
。 Rebase ( 变 基 ) 





允许 你 改变 分 支 历史 记录 中 提交 的 存放 方式 。 通 常用 于 将 多 个 提交 压缩 成 一 个 提交 ,来 
清理 分 支 ， 并 且 保 持 与 另 一 个 分 支 处 于 最 新 状态 。 














。 Revert (还 原 ) 


还 原 共 享 分 支 上 一 个 特定 提交 中 做 出 的 变更 。 这 个 命令 与 提交 搭配 使 用 ， 返 回 一 个 干净 


的 工作 目录 。 
在 下 一 章 中 ， 你 将 会 








始 整 合 本 地 仓库 中 的 工作 与 











团队 中 其 他 人 的 工作 。 
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前 几 次 与 其 他 人 合作 完成 项 目的 经 历 将 会 形成 你 使 用 版 本 控制 的 方式 。 如 果 你 的 合作 者 十 
分 耐心 并 且 富 有 同 理 心 ， 你 更 有 可 能 会 自信 地 使 用 版 本 控制 。 富 有 同 理 心 的 队友 会 在 文档 
中 记 下 他 们 希望 你 使 用 的 流程 ， 并 且 耐 心 回答 你 的 问题 (在 必要 时 更 新 文档 )。 如 果 你 负 
责 启动 一 个 项 目 ， 可 以 想 想 Jerry Maguire 对 他 的 明星 球员 所 说 的 “我 来 帮 你 ”。 作 为 项 目 
负责 人 ， 这 应 该 是 你 的 口头 禅 。 找 到 症结 并 解决 它们 。 在 你 希望 保持 一 致 的 地 方 ， 提 供 详 
细 的 指示 、 模 板 和 自动 化 的 脚本 。 当 有 些 地 方 没 有 达到 你 的 期 望 时 ， 将 它 看 作 是 你 应 该 解 
决 的 流程 问题 。 

在 本 章 中 ， 我 们 将 本 书 之 前 学 到 的 内 容 推 向 了 高 钴 。 在 第 一 部 分 中 ， 你 学 到 了 关于 设置 项 
目 时 的 不 同 考 虑 事项 。 现 在 ， 你 将 会 学 习 如 何 落实 这 些 决 定 。 在 第 5 章 和 第 6 章 中 ， 你 学 
到 了 开发 者 每 天 运行 的 命令 。 在 本 章 中 ， 你 将 会 学 习 如 何 建立 远程 项 目 连接 ， 并 将 你 的 工 
作 与 他 人 共享 。 

完成 本 章 学 习 之 后 ， 你 将 具备 以 下 技能 。 

。 在 代码 托管 系统 上 设置 一 个 新 的 项 目 
。 使 用 clone 下 载 一 个 远程 仓库 

。 使 用 push 将 你 的 变更 上 传 到 一 个 仓库 
。 使 用 fetch 刷新 远程 仓库 中 的 可 用 分 支 列表 

。 使 用 pull 合并 远程 仓库 中 的 变更 

。 解释 使 用 pull, rebase 和 merge 更 新 分 支 带 来 的 影响 

本 章 尽 可 能 提供 了 帮助 新 来 开发 者 上 手 的 模板 。 贡 献 有 用 的 工作 越 容易 ， 人 们 就 越 享受 为 
你 的 项 目 工作 。 即 使 这 只 是 一 份 工 作 ， 我 们 的 生活 也 没有 理由 不 可 以 有 更 多 乐趣 。 


喜欢 通过 视频 教程 学 习 的 读者 可 以 参考 本 书 附带 的 系列 视频 ，Collaborating with Git (http:// 
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shop.oreilly.com/product/0636920034872.do) 。 


7.14 设置 项 目 


项 目的 背景 将 在 很 大 程度 上 决定 如 何 设置 仓库 。 为 了 保证 隐私 ， 我 们 会 建立 一 个 绝密 的 内 
部 代码 库 ， 为 了 体现 透明 并 鼓励 参与 的 风格 ， 我 们 会 建立 一 个 免费 的 开源 代码 库 。 一 旦 项 
目 建立 ， 开 发 人 员 每 一 天 中 使 用 的 命令 可 能 会 非常 相似 。 

本 节 介 绍 了 在 代码 托管 系统 中 创建 一 个 新 项 目的 基本 流程 。GitHub、Bitbucket 和 GitLab 
中 的 细节 将 在 第 三 部 分 中 (分别 在 第 10 章 、 第 11 章 和 第 12 章 中 ) 介绍 。 


7.1.1 创建 新 项 目 


为 了 与 你 的 团队 共享 工作 ， 你 需要 在 选择 的 代码 托管 系统 中 建立 一 个 新 的 项 目 。 如 今 ， 大 
多 数 代码 托管 系统 远 远 不 只 是 一 个 能 够 储存 共享 仓库 的 地 方 。 它 们 还 提供 了 工 单 系统 、 基 
本 的 工作 流 优化 、 项 目 文档 仓库 和 更 多 功能 ! 我 参与 过 的 社区 和 团队 通常 使 用 以 下 三 个 服 
务 之 一 : GitHub (通常 用 于 开源 项 目 )、Bitbucket (通常 用 于 内 部 团队 和 想 要 免费 私有 项 目 
托管 的 小 团队 ) 和 GitLab (通常 用 于 因为 安全 原因 需要 在 内 部 托管 代码 的 中 型 公司 )。 


不 论 你 选择 哪个 系统 ， 设 置 项 目的 基本 流程 都 是 一 样 的 。 你 需要 先 问 自己 一 个 问题 ， 你 
要 用 什么 账户 来 创建 这 个 仓库 ? 在 基于 Web 的 系统 中 ,项目 URL 的 基本 格式 如 下 : 
https://<hosting-url.com>/<project-owner’s-name>/<projectname>。 如果 这 个 项 目 确实 是 你 
的 (例如 ， 个 人 博客 的 仓库 )， 那 么 你 可 以 在 URL 中 包含 你 的 用 户 名 。 然 而 ， 如 果 这 个 项 
目 属 于 一 个 开发 者 组 织 ， 用 组 织 的 名 称 来 命名 项 目 所 有 者 会 更 合适 。 最 后 ， 如 果 项 目 从 属 
于 不 止 一 个 组 织 ， 如 对 于 一 个 开源 软件 项 目 而 言 ， 使 用 软件 项 目 来 命名 项 目 所 有 者 最 为 合 
Me 


你 选择 的 决策 可 能 还 会 影响 对 项 目 拥有 直接 写 入 权限 的 人 ， 他 可 能 独立 于 你 所 使 用 的 代码 
托管 系统 。 例 如 ， 如 采 你 选择 使 用 你 个 人 的 名 字 来 启动 一 个 项 目 ， 你 可 能 不 希望 随便 谁 都 
可 以 不 经 你 的 审查 写 入 项 目 ， 尤 其 是 在 公开 项 目 中 ， 其 他 人 评价 工作 内 容 时 可 能 会 假设 这 
些 工作 都 是 你 的 。 


名 字 有 什么 意义 ? 

这 些 年 本 书 的 支持 仓库 出 现在 很 多 不 同 的 地 方 ， 包 括 我 的 个 人 账户 、 一 个 团 
队 账 户 和 三 个 不 同 的 代码 托管 系统 (总 共有 六 个 不 同 的 仓库 需要 维护 ) 中 。 
尽管 这 些 工 作 是 由 我 开发 的 ， 但 想 要 分 发 到 绑 定 的 哪个 URL 渐渐 成 为 了 问 
题 。 如 果 我 希望 其 他 人 将 这 个 仓库 视 为 他 们 的 〈 例 如 在 一 些 人 们 无 法 找到 我 
的 某 套 抽象 的 学 习 资 料 中 ) ， 我 或 许 会 使 用 项 目 URL。 但 当 我 希望 人 们 知道 
我 是 作者 ， 因 为 这 也 是 自我 推广 的 好 机 会 ， 我 或 许 会 把 我 的 个 人 URL 给 他 
们 。 很 有 可 能 我 过 度 解 读 了 名 字 的 意义 ， 但 你 至 少 应 该 考虑 一 下 各 种 东西 的 
命名 。 









































































































































在 阅读 本 书 时 ， 你 或 许 是 团队 中 的 一 员 (即使 是 不 能 再 小 的 单 人 团队 ! )， 作 为 项 目的 所 
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有 者 ， 你 希望 为 你 的 公司 、 组 织 或 团队 选择 一 个 名 称 ， 如 果 你 正在 进行 一 个 开源 项 目 ， 你 
还 要 为 项 目 选择 一 个 名 称 。 幸 运 的 是 ， 你 可 以 轻易 地 将 代码 库 移 到 另 一 个 名 称 或 者 甚至 是 
另 一 个 代码 托管 平台 ， 因 此 一 开始 就 想 好 正确 的 名 称 并 不 是 至 关 重 要 的 。 然 而 ， 将 项 目的 
元 数据 从 一 个 账户 迁移 到 另 一 个 账户 会 更 加 困难 。 元 数据 可 能 包括 项 目 中 工 单 的 历史 记录 
以 及 仓库 外 存放 的 文档 。 


选 好 项 目 所 有 者 ， 然 后 在 此 账户 下 建立 一 个 新 的 空 项 目 。 不 要 担心 文件 还 设 有 上 传 。 


7.1.2 ”建立 权限 管理 


你 需要 为 你 的 项 目 设置 两 种 权限 : 谁 能 够 看 到 这 个 项 目 (“ 读 ”)， 以 及 谁 可 以 提交 到 这 个 
项 目 (“ 写 ”)， 对 此 我 们 在 第 2 章 中 已 进行 过 详细 的 讨论 。 如 果 你 的 团队 是 一 个 超级 透明 
的 团队 ， 项 目 应 该 对 全 世界 可 见 。 否 则 请 创建 一 个 私有 项 目 。 


免费 服务 的 代价 

一 些 代码 托管 服务 会 对 私有 项 目 收取 少量 费用 ， 而 另 一 些 则 免费 提供 服务 。 
如 果 你 的 代码 和 历史 记录 很 重要 ， 请 考虑 付费 托管 。 你 可 以 选择 付出 时 间 的 
代价 搭建 内 部 的 代码 托管 ， 也 可 以 选择 以 付出 少量 月 费 为 代价 使 用 一 个 第 三 
方 服务 。 付 费 的 好 处 是 托管 公司 更 有 可 能 把 你 当 作 一 个 客户 ， 通 过 付费 弥补 
他 们 的 支出 ， 你 能 够 更 好 地 为 他 们 的 业务 生存 提供 帮助 。 当 然 ， 如 果 你 无 法 
负担 这 个 费用 ， 你 也 有 很 多 免费 的 选项 ， 如 果 一 家 公司 选择 提供 的 免费 服 
务 ， 你 也 没 必要 感到 羞愧 。 做 你 能 做 的 。 









































此 外 ， 一 些 托管 系统 允许 你 设置 分 支 特有 的 限制 。 目 前 Bitbucket 和 GitLab 提供 这 个 功能 。 
设置 选项 分 别 在 第 11 章 和 第 12 HPNA. 

作为 一 个 分 布 式 版 本 控制 系统 ，Git 本 身 在 处 理 仓库 中 产生 的 变更 请 求 时 表现 良好 。 一 般 
来 说 ， 团 队 项 目 会 有 一 个 称 为 “项 目 ”( 主 项 目 ) 的 单独 仓库 ， 和 许多 包含 每 个 开发 者 工 
作 的 衍生 项 目 。 如 有 果 你 在 内 部 项 目 中 工作 ， 则 可 以 选择 让 所 有 人 直接 在 “项 目 ” 的 仓库 中 
工作 ; 但 如 果 你 倾向 于 维护 一 个 干净 的 中 央 仓 库 ， 则 可 以 选择 让 每 个 开发 者 在 一 份 派生 的 
“项 目 ” 中 工作 。 























项 目 

在 本 章 中 ， 你 将 会 多 次 见 到 “项 目 ” 这 种 说 法 。 我 使 用 这 个 缩写 来 指 代 一 个 
软件 项 目 主要 的 或 者 官方 的 仓库 。 社 区 同意 将 这 个 仓库 用 作 软 件 的 官方 发 
fü. Git 本 身 没 有 内 部 机 制 来 强制 规定 一 个 仓库 比 另 一 个 仓库 更 重要 。 只 
社区 的 声明 会 使 一 个 仓库 成 为 官方 仓库 。 





























根据 你 在 第 2 章 中 做 出 的 关于 团队 结构 的 决策 ， 为 所 有 贡献 者 分 配合 适 的 权限 ， 决 定 谁 可 
以 拥有 “仓库 ”的 写 入 权限 ， 甚 他 未 认证 的 开发 者 的 贡献 可 以 通过 拉 取 请 求 〈 在 一 些 服务 
中 也 称 为 合并 请 求 ) 来 接受 。 








7.4.8. 上 传 项 目 仓 库 

作为 一 个 分 布 式 版 本 控制 系统 ，Git 像 是 一 个 交际 花 。 它 喜欢 连接 各 种 仓库 ， 它 喜欢 分 享 
故事 ， 并 一 路 结交 新 的 朋友 。Git 通过 储存 一 个 称 为 远程 (remote) 的 连接 来 联系 远方 的 朋 
友 。 本 地 仓库 可 以 有 零 个 、 一 个 或 多 个 远程 连接 。 通 常情 况 下 ，Git 仓库 只 有 一 个 远程 连 
接 ， 即 origin ( 源 )。 你 可 能 已 经 见 过 了 这 个 术语 。 分 配给 远程 仓库 的 这 个 别名 ， 从 中 下 载 
或 克隆 了 你 的 本 地 副本 。 你 可 以 使 用 任何 你 喜欢 的 名 称 来 命名 你 的 远程 连接 。 

在 你 第 一 次 启动 一 个 新 项 目 时 ， 可 能 还 没有 现成 的 代码 ， 也 可 能 有 了 一 些 代 码 。( 这 显 而 易 
见 ， 不 是 么 ? ) 如 果 你 还 没有 代码 ， 那 么 可 以 遵循 代码 托管 系统 中 的 指示 ， 将 这 个 空 项 目 
克隆 到 你 本 地 的 开发 环境 中 。 然 而 ， 如 果 你 在 本 地 已 经 有 了 一 些 代码 ， 那 么 将 会 想 要 上 传 
你 已 有 的 代码 。 要 想 这 么 做 ， 你 需要 建立 一 个 从 你 的 本 地 仓库 到 项 目 托管 服务 的 新 连接 。 


在 项 目 仓库 的 本 地 副本 中 ， 检 查 你 是 否 已 经 设置 好 一 个 远程 连接 ， 如 下 所 示 。 


$ git remote --verbose 


如 果 你 从 本 地 启动 项 目 ， 就 不 会 看 到 任何 远程 连接 ， 因 此 ， 如 果 现在 什么 都 没有 显示 也 没 
关系 。 如 果 你 为 这 个 仓库 设置 了 一 个 远程 连接 ， 将 会 看 到 如 下 内 容 。 


origin https://github.com:emmajane/gitforteams.git (fetch) 
origin https://github.com:emmajane/gitforteams.git (push) 


每 行 都 以 远程 连接 (origin) 的 别名 开头 ， 后 跟 远 程 仓 库 的 原 地 址 。 这 些 行 总 是 会 成 对 出 
现 : 每 一 对 的 第 一 行 表明 你 将 从 哪里 获取 新 的 工作 (fetch), ， 而 第 二 行 表明 你 会 将 新 的 工 
作 上 传 到 哪里 (push), 

项 目 所 有 者 需要 连接 到 项 目的 官方 副本 ， 如 果 他 们 在 合并 工作 前 需要 经 历 同行 评审 的 过 
程 ， 那么 可 能 还 需要 连接 到 一 个 派生 的 项 目 (同行 评审 在 第 8 章 中 介绍 )。 一 旦 你 开始 为 
某 个 项 目 添加 多 个 远程 仓库 ， 默 认 的 别名 (origin) 会 令 人 有 些 困惑 。 因 此 ， 我 倾向 于 根 
据 仓 库 的 不 同 目的 来 命名 ， 例 如 对 于 你 来 说 有 意义 的 official (官方 ) 和 personal (个 
人 )。 在 我 上 传 工作 时 ， 会 在 这 两 个 选项 中 选择 一 个 使 用 。 在 标准 Git 术语 中 ， 我 的 别名 是 
upstram 和 origin， 尽 管 origin 默认 被 分 配给 克隆 仓库 的 源 ， 不 管 你 是 否 拥 有 写 入 权限 。 


命名 

我 已 经 用 了 很 长 时 间 的 Git， 但 我 还 是 动不动 就 记 错 git remote show 
origin 这 个 命令 。 四 个 单词 。 记 住 顺 序 对 我 并 不 难 ， 对 吧 ? 但 我 似乎 从 来 都 
记 不 住 show fll origin 的 顺序 。 用 我 自己 的 名 称 命名 远程 仓库 之 后 ， 我 更 可 
能 理解 这 个 命令 的 意义 ， 从 而 记 住 正确 的 顺序 。git remote show official 
对 我 来 说 似乎 就 更 好 记 一 些 。 你 可 能 从 来 没有 遇 到 过 这 个 问题 ， 但 如 果 你 记 
忆 这 个 命令 很 费劲 ， 那 么 或 许 会 希望 自 定 义 你 的 远程 名 称 ， 将 origin 改 为 
你 顺口 的 名 称 。 
























































































































































要 添加 一 个 远程 连接 ， 你 需要 首先 知道 项 目的 URL。URL 的 结构 通常 是 https://<hosting- 
url.com>/<project-owner’s-name>/<projectname>.git。 在 新 版 本 的 Git 中， 你 还 可 以 使 用 
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https 协议 ， 但 以 前 的 文档 中 ， 第 一 部 分 可 能 被 替换 为 git@hostingurl. com, 一旦 你 知道 了 
远程 仓库 的 URL， 就 可 以 连接 上 去 〈 例 7-1)。 


例 7-1 添加 一 个 远程 仓库 连接 


$ git remote add nickname project-url 


在 连接 上 远程 仓库 后 ， 你 应 该 可 以 在 列 出 远程 连接 时 看 到 新 增 的 两 行 。 如 果 你 希望 使 用 
Git 的 术语 ， 那 么 应 该 使 用 别名 upstram 来 代表 官方 项 目 仓库 ， 如 果 你 使 用 我 的 命名 约定 ， 
那么 应 该 使 用 official。 这 个 名 称 永远 不 会 被 发 布 ， 没 有 Git 警察 会 来 纠正 你 ， 因 此 你 可 
以 取 任 何 你 想 要 的 名 称 ， 设 有 人 会 知道 。[ 如 果 你 喜欢 ， 甚 至 可 以 叫 它 cookies (Ha) 或 
coffee (咖啡 )。 真 的 无 所 谓 。] 


例如 ， 如 果 我 是 一 个 名 为 Mounties 的 项 目 中 的 一 员 ， 这 个 项 目 由 一 个 名 为 Oh, Canada 的 
机 构 运作 ， 我 的 一 系列 远程 连接 会 如 下 所 示 。 


$ git remote --verbose 






































official https://github.com:ohcanada/mounties.git (fetch) 
official https://github.com:ohcanada/mounties.git (push) 
personal https://github.com:emmajane/mounties.git (fetch) 
personal https://github.com:emmajane/mounties.git (push) 


只 要 你 喜欢 ， 就 可 以 很 容易 地 建立 许多 远程 连接 。 例 如 ， 你 可 能 有 devserver (开发 服务 
器 )、staging ( 暂 存 ) 和 production (生产 ) 的 远程 连接 ， 或 者 你 可 能 会 直接 登录 到 那些 
机 器 上 ， 拉 取 主 项 目 仓库 中 的 代码 ， 而 不 是 直接 将 代码 推送 到 这 些 地 方 。 

如 果 你 已 经 在 本 地 仓库 中 设置 好 了 一 个 不 再 需要 的 远程 连接 ， 那 么 可 以 轻易 地 删除 它 
( 例 7-2)。 

例 7-2 移 除 一 个 远程 连接 


$ git remote remove nickname 





























你 可 以 轻易 地 重 命名 远程 连接 ， 甚 至 为 本 地 仓库 中 的 每 个 分 支 设置 默认 的 远 
程 连接 。Git 关于 这 个 命令 的 自 带 文档 清晰 易 懂 。 如 果 你 希望 更 进一步 地 自 
定义 你 的 远程 列表 ， 那 么 应 该 阅读 一 下 这 份 文档 。 











在 你 的 项 目 中 创建 了 远程 连接 之 后 ， 现 在 你 可 以 将 仓库 的 本 地 副本 上 传 到 远程 服务 器 ， 如 
下 所 示 。 


$ git push nickname branch name 
如 果 你 希望 与 别人 共享 所 有 的 本 地 分 支 ， 可 以 修改 这 个 命令 ， 如 下 所 示 。 
$ git push --all nickname 
一 旦 你 上 传 了 你 的 工作 ， 请 浏览 项 目 页 面 ， 确 保 仓 库 按照 预 期 上 传 了 。 默 认 情 况 下 ， 大 多 


数 代 码 托管 系统 会 显示 分 支 master， 如 果 仓 库 中 有 超过 一 个 分 支 ， 并且 你 的 本 地 仓库 使 用 
了 非 标准 的 分 支 名 ， 那 么 去 看 看 你 的 代码 托管 系统 是 否 允 许 你 为 仓库 分 配 默 认 分 支 。 这 个 
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分 支 通常 是 项 目 最 稳定 的 版 本 ， 而 试验 性 的 工作 会 出 现在 其 他 分 文 。 当 然 ， 每 个 项 目 略 有 
不 同 。 你 的 项 目 可 能 将 master 分 支 当 作 新 工作 的 接合 处 ， 而 不 是 软件 最 稳定 的 版 本 。 请 在 
你 的 文档 中 明确 记录 这 些 信息 。 

要 将 本 地 名 称 上 传 到 远程 服务 器 上 的 某 个 新 名 称 下 ， 请 使 用 以 下 语法 。 


$ git push nickname branch local:branch remote 


例如 ， 如 果 你 希望 将 你 的 main 分 支 上 传 到 远程 仓库 official 并 在 远程 仓库 中 将 这 个 分 支 
命名 为 master， 则 会 使 用 下 面 的 命令 。 


$ git push official main:master 


现在 ， 你 的 本 地 仓库 应 该 已 经 被 上 传 到 了 远程 项 目 仓 库 ， 并 且 使 用 了 你 想 要 的 分 支 名 。 


7.1.4 在 README 中 记录 项 目 


当 你 访问 项 目 页 面 时 ， 将 会 注意 到 大 多 数 代 码 托管 系统 将 会 显示 README 文件 的 内 容 
(如 果 你 的 项 目 中 存在 README 文件 )。 这 个 文件 应 该 用 于 向 人 们 概述 项 目 。 如 果 这 是 一 
个 包含 依赖 的 开发 项 目 ， 那 些 项 目 依赖 应 该 在 README 文件 中 列 出 。 如 果 有 安装 说 明 ， 
那么 也 应 该 在 README 文件 中 列 出 (或 提供 链接 ， 指 向 更 完整 的 安装 指南 )。 如 果 你 希望 
人 们 为 项 目 做 出 贡献 ， 或 者 向 项 目 报告 bug， 那么 这 些 说 明 也 应 在 README 文件 中 列 出 。 


下 面 的 项 目 有 着 优秀 的 README 文件 ， 它 们 清楚 地 解释 了 这 个 仓库 是 什么 ， 如 何 使 用 其 
中 的 代码 ， 以 及 你 可 以 如 何 对 其 做 出 贡献 ， 如 下 所 示 。 


e Sculpin (https://github.com/sculpin/sculpin) 
e Sass (https://github.com/sass/sass) 
e Rails (https://github.com/rails/rails) 


为 你 的 项 目 选择 一 份 许可 证 

世界 上 没有 通行 的 版 权 法 律 。 因 此 ， 任 何不 包含 明确 许可 证 的 项 目 都 被 假定 
为 完全 受 版 权 保护 ， 不 希望 被 二 次 使 用 。 坦 诚 地 说 ,我 的 不 少 项 目 都 没有 包 
含 许可 证 。 通 常 这 只 是 因为 我 还 没有 想 好 如 何 让 别人 使 用 我 的 工作 。( 在 我 
编写 培训 材料 的 圈子 里 ， 版 权 归属 的 限制 比 开 源 许可 盛行 的 代码 社区 中 更 加 
Pup.) 一 个 仓库 的 许可 证 通常 位 于 LICENSE 文件 或 LICENSE.txt 文件 中 。 
























































































































































如 果 你 的 本 地 仓库 还 没有 README 文件 ， 现 在 就 是 添加 的 好 机 会 ! 现在 ， 新 的 项 目 流 行 
Markdown 格式 的 README 文件 ， 因 此 将 文件 重 命名 为 README.md 来 确保 文件 的 格式 
正确 。 


在 项 目 上 传 并 且 创 建 这 些 说 明之 后 ， 现 在 是 时 候 开 始 把 贡献 者 加 入 到 项 目 中 来 了 。 你 在 本 
章 剩余 部 分 中 使 用 的 流程 应 该 以 文档 的 形式 加 入 你 的 仓库 。 它 会 允许 开发 者 拥有 一 份 本 地 
副本 ， 并 允许 他 们 更 容易 地 访问 到 这 些 信息 ， 而 不 必 参 考 外 部 wiki 页 面 。 


现在 ， 你 的 项 目 已 经 就 绪 ， 是 时 候 换个 视角 ， 从 贡献 者 的 角度 来 看 待 事情 了 。 
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7.2 ”设置 开发 者 


当 你 从 开发 者 的 角度 审视 项 目 时 ， 并 不 总 是 完全 清楚 应 该 参与 到 什么 程度 。 在 公开 的 项 目 

中 ， 开 发 者 可 能 的 参与 程度 分 为 以 下 三 个 层次 。 

。 下 载 项 目的 压缩 包 ， 再 也 不 回 到 项 目 页 面 。 这 可 能 出 现在 真正 的 派生 项 目 中 ， 下 游 开 发 
者 不 打算 回去 查看 代码 的 演进 。 它 还 可 以 用 于 被 设计 为 起 始点 的 项 目 ， 开 发 者 的 目的 是 
分 析 代 码 并 且 大 量 修改 源码 。 

。 为 了 保持 本 地 代码 最 新 而 克隆 项 目 仓库 ， 但 不 打算 修改 项 目 。 这 个 想法 适用 于 在 项 目 中 
用 到 开源 库 的 开发 者 。 这 些 开发 者 可 能 会 扩展 库 ， 或 许 对 克隆 库 进 行 少量 修改 。 但 大 多 
数 情况 下 ， 他 们 直接 使 用 库 的 代码 ， 依 靠 上 游 开 发 者 的 改进 和 安全 更 新 。 

。 为 了 贡献 工作 而 克隆 项 目 仓库 。 这 个 想法 适用 于 开源 项 目的 志愿 者 和 工作 人 员 ， 软 件 项 
目的 内 部 开发 者 ， 以 及 为 某 个 特定 项 目的 构建 做 出 贡献 的 机 构 员工 。 

后 两 个 选择 最 主要 的 区 别 在 于 ， 非 贡献 者 一 般 会 选择 直接 殉 隆 主 项 目 ， 而 贡献 者 除了 项 目 

仓库 之 外 ， 可 能 还 有 一 个 个 人 仓库 。 这 些 选择 的 原因 在 第 2 章 中 有 更 详细 的 介绍 。 

消费 者 与 贡献 者 
有 具有 前 脆性 (中 级 到 高 级 ) 的 开发 者 总 会 假设 他 们 会 在 某 个 时 候 贡 献 回 项 

目 ， 并 创建 自己 中 间 的 远程 仓库 。 然 而 ， 大 多 数 新 手 开发 者 则 尽 可 能 简化 自 

己 的 工作 流程 ， 名 略 了 创建 自己 的 远程 仓库 的 中 间 步 骤 。 这 也 意味 着 他 们 将 

自己 视 为 你 的 项 目的 消费 者 ， 而 不 是 一 个 潜在 的 贡献 者 。 































































































一 旦 开发 者 把 自己 当 作 消 费 者 或 贡献 者 (包含 主要 维护 者 )， 就 可 以 选择 一 种 方法 来 下 载 
你 的 项 目 仓库 。 


7.2.1 消费 者 

消费 者 不 打算 为 项 目 做 出 贡献 。 他 们 不 期 望 拥有 代码 库 的 写 入 权限 ， 在 上 传 自己 的 更 改 时 
也 没有 预计 未 来 的 后 果 。 这 类 开发 者 可 能 会 通过 以 下 两 种 方式 来 下 载 你 的 仓库 。 
。 以 压缩 包 的 形式 。 

。 以 仓库 的 克隆 (直接 从 “项 目 ” 页 面 ) 的 形式 。 

压缩 包 与 “项 目 ” 没 有 任何 联系 ， 也 不 包含 一 直 以 来 的 变更 历史 。 男 一 方面 ， 殉 隆 
(clone) 维持 了 项 目的 连接 ， 并 可 以 通过 运行 一 些 Git 命令 更 新 到 最 新 的 版 本 。 克 隆 一 个 
远程 仓库 的 结构 如 下 所 示 。 


$ git clone https://«hosting-url.com»/«project-owner ' s-name»/«project-name».git 


例如 ， 如 果 你 想 要 为 “Git 团队 协作 ”工作 坊 下 载 一 份 项 目 仓 库 的 副本 ， 可 以 使 用 下 面 的 


AA 
命令 。 



































$ git clone https://github.com/gitforteams/gitforteams.git 





为 了 更 新 仓库 的 本 地 副本 ， 首 先 你 需要 fetch ( 拉 取 )“ 项 目 ” 最 新 的 变更 〈 此 处 ， 我 们 假 
设 你 只 有 一 个 远程 连接 ) ， 如 下 所 示 。 
$ git fetch --all 
一 旦 你 拉 取 完 这 些 变 更 ， 在 决定 更 新 你 的 本 地 副本 前 ， 可 以 比较 本 地 版 本 与 最 新 版 本 ， 看 
看 发 生 了 哪些 修改 。 
首先 ， 列 出 仓库 中 所 有 分 支 ， 如 下 所 示 。 
$ git branch --all 
你 将 会 看 到 两 组 分 支 : 你 的 本 地 分 支 和 远程 跟踪 分 支 。 当 前 被 签 出 的 分 支 将 会 用 * 标记 。 
我 之 前 自己 克隆 的 项 目 仓 库 如 下 所 示 。 
gh-pages 
master 
video-lessons 
remotes/personal/gh-pages 


remotes/personal/master 
remotes/personal/video-lessons 


列表 显示 了 三 个 本 地 分 支 和 三 个 连接 到 personal 远程 仓库 的 分 支 。 
为 了 获取 每 个 分 支 中 的 更 多 细节 ， 请 使 用 - -verbose 参数 ， 如 下 所 示 。 
$ git branch --all --verbose 


输出 包括 提交 说 明 以 及 每 个 分 支 的 状态 (与 远程 仓库 相 比 )， 如 下 所 示 。 














* 











gh-pages 629b54f Resolving merge conflict; ... 
* master 2db982d Changes to "Undo" graphic: ... 
video-lessons 7798eb1 [ahead 11] Lesson 00: 
remotes/personal/gh-pages 629b54f Resolving merge conflict; 
remotes/personal/master 2db982d Changes to "Undo" graphic 
remotes/personal/video-lessons 653f875 Lesson 7: Added intro on 








为 了 查看 添加 到 仓库 的 master 分 支 上 的 变更 历史 记录 ， 你 可 以 使 用 log 命令 ， 如 下 所 示 。 
$ git log personal/master 

为 了 比较 你 本 地 的 分 支 副 本 和 刚 下 载 的 更 新 ， 你 可 以 添加 - - patch 来 查看 每 个 提交 的 更 改 ， 

或 使 用 diff 命令 查看 所 有 变更 的 摘要 ， 如 下 所 示 。 


$ git log --patch personal/master 
$ git diff master personal/master 


这 个 命令 会 以 补丁 的 格式 展示 所 有 变更 。 寻 找 被 添加 〈 标 记 为 +) 或 被 删除 〈 标 记 为 -) 
的 行 。 如 果 你 倾向 于 签 出 整个 代码 库 ， 可 以 签 出 分 支 顶端 ， 如 下 所 示 。 

$ git checkout personal/master 
你 将 会 处 于 分 离 式 HEAD 状态 。 签 出 master 分 支 以 回 到 其 本 地 副本 ， 如 下 所 示 。 


$ git checkout master 
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一 且 你 评审 完 这 些 更 改 ， 就 可 以 通过 变 基 更 新 master 分 支 的 本 地 副本 ， 从 而 添加 新 的 更 
改 ， 如 下 所 示 。 


$ git rebase personal/master 


使 用 rebasse 命令 可 提供 一 个 更 干净 的 图 形 化 历史 记录 。 但 是 ， 如 果 你 的 团队 选择 使 用 合 
并 ,那么 你 可 以 使 用 merge 命令 来 更 新 你 的 本 地 分 支 ， 如 下 所 示 。 


$ git merge personal/master 


如 果 你 有 多 个 想 要 更 新 的 分 支 ， 则 需要 单独 检查 每 个 分 支 ， 并 使 用 相同 的 流程 来 合并 修 
改 。 你 需要 每 次 处 理 一 个 分 支 ， 因 为 如 果 两 个 分 支 的 副本 之 间 出 现 了 冲突 ，Git 需要 给 你 
一 个 工作 目录 来 解决 冲突 。 


项 目的 消费 者 只 需要 用 到 上 面 儿 个 命令 。 然 而 ， 如 果 开 发 者 在 本 地 略微 修改 了 她 的 仓库 副 
本 ， 并 想 要 将 更 改 贡 献 回 项 目 ， 她 只 能 提交 一 个 补丁 ， 或 请 求 开 发 者 权限 (对 于 一 次 性 贡 
献 者 来 说 不 太 可 能 得 到 授权 )。 虽 然 她 可 以 提交 补丁 ， 但 这 不 是 最 好 的 选择 。( 是 的 ， 有 一 
些 项 目 仍然 在 使 用 补丁 ， 包 括 Git 项 目 本 身 ! ) 相反 ， 很 多 项 目 都 倾向 于 使 用 拉 取 请 求 。 
这 个 术语 起 源 于 GitHub， 后 来 在 其 他 系统 上 也 流行 开 来 。 一 个 拉 取 请 求 是 一 个 元 功能 ， 它 
不 是 Git 的 内 置 功 能 ， 而 是 Git 的 辅助 软件 的 功能 。 它 为 项 目 维护 者 提供 了 一 个 可 视 化 的 
提示 ， 以 合并 远程 仓库 中 的 一 个 工作 分 支 。 两 个 仓库 之 间 的 连接 只 存在 于 某 次 特定 的 请 求 
中 。 这 个 连接 不 是 持续 的 ， 与 开发 者 在 自己 的 本 地 工作 站 中 设置 的 远程 仓库 连接 不 同 。 


7.2.2 贡献 者 


你 认为 你 有 兴趣 为 一 个 软件 项 目 做 出 贡献 。 太 棒 了 ! (作为 本 书 作 者 ， 我 感到 很 释然 。 如 
果 你 看 到 了 这 里 ， 负 然 没 有 兴趣 参与 一 个 软件 项 目 ， 我 会 感觉 很 糟糕 。) 作为 一 个 分 布 式 
版 本 控制 系统 ，Git 专注 于 你 在 本 地 可 以 做 什么 。 用 于 共享 仓库 之 间 直 接 协 作 的 内 置 工具 
非常 简单 ， 不 论 你 是 否 拥有 项 目 完整 的 写 入 权限 。Git 中 没有 分 支 单独 的 权限 。 事 实 上 ， 
如 果 不 考 虑 SSH XH, Git 中 完全 没有 任何 认证 系统 。Git 依赖 外 层 软 件 来 提供 访问 控制 。 
为 了 使 外 层 软件 在 两 个 仓库 间 建 立 连 接 ， 会 要 求 这 两 个 仓库 可 以 从 同一 个 地 方 访问 到 。 为 
此 ， 最 简单 的 方法 是 让 开发 者 将 他 们 的 更 改 上 传 到 主 项 目 仓库 所 在 的 系统 。GitHub 和 其 他 
基于 Web 的 系统 都 会 元 隆 或 派生 “项 目 "， 并 将 你 的 更 改 上 传 到 复制 的 仓库 。 然 后 ， 使 用 
外 层 软 件 来 请 求 将 你 的 变更 拉 取 到 “项 目 ” 仓 库 。 


使 用 GitHub 术语 的 步骤 如 下 所 示 。 


(1) 一 个 想 要 做 出 贡献 的 开发 者 (“开发 者 ”) RET “WE” CE. 

(2) 然后 ,“ 开 发 者 ”可 以 在 自己 的 “项 目 ” 副 本 中 提出 建议 的 更 改 。 

(3) 完成 后 ,“ 开 发 者 ”发 起 一 个 从 她 项 目 副本 中 的 一 个 分 支 到 “项 目 ” 仓 库 的 拉 取 请 求 。 

(4) “开发 者 ”和 “维护 者 ”将 使 用 GitHub 网 页 上 的 评论 功能 来 进行 讨论 。 有 时 ， 在 “维护 
者 ”接受 提议 ， 更 改进 入 “项 目 ” 前 ,，“ 开 发 者 ”需要 进行 一 些 更 新 。 

(5) 如 果 提 议 的 更 改 对 项 目 有 益 , “维护 者 ”会 将 这 个 拉 取 请 求 并 入 “项 目 ” 




















































































































GitHub 不 需要 你 将 “项 目 ” 克 隆 到 本 地 

现在 ，GitHub 人 允许 开发 者 在 网 页 上 直接 对 文件 进行 简单 的 编辑 。 但 是 ， 很 多 
开发 者 选择 克隆 一 份 “项 目 ”的 副本 ， 以 便 在 本 地 工作 。 然 后 ， 当 他 们 完成 
自己 的 工作 后 ， 将 更 新 推送 到 自己 的 项 目 副本 ， 发 起 一 个 从 自己 的 项 目 副本 
到 主 项 目 仓库 的 拉 取 请 求 。 
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提交 拉 取 请 求 的 流程 根据 所 使 用 的 外 层 软 件 (例如 GitHub, Bitbucket, GitLab 等 ) 不 同 而 
略 有 区 别 。 不 过 ， 基 本 的 流程 会 在 第 三 部 分 中 介绍 。 


7.2.3 维护 者 

拥有 “项 目 ” 仓 库 直 接 的 提交 权限 的 开发 者 是 一 种 特殊 类 型 的 开发 者 ， 称 为 “维护 者 ”。 
根据 你 的 团队 结构 ,， “维护 者 ”可 能 是 质量 保证 团队 内 部 的 成 员 ， 也 可 能 是 社区 中 精心 挑 
选 的 开发 者 。 对 于 小 型 内 部 项 目 来 说 , “维护 者 ”可 能 是 正在 为 项 目 工 作 的 任何 人 。 

在 第 2 章 中 ， 你 了 解 了 一 些 关 于 项 目 治 理 模 型 的 知识 。 “维护 者 ”参与 项 目的 方式 是 政治 
决策 ， 而 不 是 技术 决策 。Git 实际 上 不 关心 你 的 项 目 结构 ， 所 以 你 需要 设计 一 个 最 适合 你 
的 系统 。 定 义 “ 消 费 者 ”和 “贡献 者 ”工作 流 相 对 容易 ， 因 为 你 并 不 真正 和 Git 打交道 ， 
而 是 使 用 由 外 层 软件 定义 的 工作 流 (对 于 “消费 者 ”来 说 ， 他 们 甚至 更 不 使 用 Git. 

如 果 你 的 团队 中 每 个 人 都 是 “维护 者 ”( 即 允许 他 们 直接 提交 到 仓库 ) ， 那 么 你 可 以 选择 是 
否 要 求 开 发 者 创建 一 份 仓库 的 单独 克隆 。 唯 一 的 限制 是 ， 你 的 代码 托管 系统 可 能 不 支持 合 
并 单个 仓库 内 部 的 分 支 。 查 看 你 选择 的 系统 ， 看 看 它 是 否 推 荐 使 用 某 种 工作 流 。 

我 一 般 和 少 于 10 个 开发 者 一 起 工作 。 我 合作 过 的 一 些 团队 选择 为 每 个 开发 者 分 配 单独 的 远 
ECE, 一些 团 队 允 许 开 发 者 直接 将 他 们 正在 进行 的 工作 提交 到 “项 目 ” 仓 库 。 在 Drupal 
项 目 中 ， 有 成 千 上 万 的 开发 者 ， 只 有 少数 人 可 以 提交 到 主 项 目 仓库 。 然 而 ， 除 此 之 外 还 有 
30 000 个 贡献 产生 的 模块 ， 其 中 每 一 个 模块 的 维护 者 都 拥有 直接 访问 项 目 仓库 的 权限 。 


一 切 以 文档 中 的 规则 为 准 
如 果 没 有 文档 规则 ， 你 的 项 目 将 会 陷 人 无 序 的 状态 。 因 此 ， 写 下 你 希望 人 们 
在 为 项 目 做 出 贡献 时 所 遵循 的 确切 步骤 。 
























































项 目 维护 者 需要 在 本 地 至 少 有 一 人 个“ 项目” 仓库 的 克隆 。 如 有 果 你 是 启动 项 目的 开发 者 ， 那 
么 已 经 拥有 此 仓库 的 本 地 克隆 。 如 有 果 不 是 ， 你 将 需要 使 用 以 下 命令 来 克隆 仓库 。 


$ git clone https://<hosting-url.com>/<project-owner 's-name>/<project-name>.git 
你 在 第 6 章 中 学 到 了 如 何 使 用 以 下 命令 在 单 人 团队 中 创建 项 目 仓库 的 克隆 ， 如 下 所 示 。 
$ git clone https://gitlab.com/gitforteams/gitforteams.git 
这 一 步 将 会 创建 仓库 的 本 地 副本 和 一 个 名 为 origin 的 远程 连接 。 
如 果 你 的 项 目 需要 ， 你 可 能 还 需要 在 代码 托管 系统 上 创建 一 份 “项 目 ” 的 克隆 。 这 在 上 一 
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隆 ， 就 可 以 将 这 个 远程 连接 添加 到 你 的 本 地 仓库 。 这 将 允许 你 在 同一 目录 中 切换 本 地 仓库 
和 远程 仓库 。 如 果 你 喜欢 ， 可 以 保留 两 个 本 地 目录 ， 但 我 个 人 非常 享受 不 用 频繁 切换 带 来 
的 高 效率 。 你 可 以 使 用 自己 的 约定 来 命名 远程 连接 。 添 加 新 的 远程 连接 的 格式 如 下 所 示 。 
$ git remote add nickname https://«hosting-url.com»/«your -name»/«project».git 
如 果 我 要 从 GitLab 添加 我 自己 的 克隆 ， 接 着 前 面 的 示例 ， 我 将 使 用 下 面 的 命令 。 因 为 这 个 
连接 对 应 的 是 我 个 人 的 仓库 副本 ， 所 以 我 将 会 使 用 personal 别名 ， 如 下 所 示 。 
$ git remote add personal https://gitlab.com/emmajane/gitforteams.git 
为 了 避免 混淆 ， 我 可 能 还 会 将 “项 目 ” 的 远程 仓库 从 origin 重 命名 为 official, AW FIR. 
$ git remote rename origin official 
这 些 别名 对 你 的 系统 来 说 是 完全 随意 和 私人 的 。 它 们 不 会 与 其 他 人 共享 ， 因 此 请 使 用 对 
你 来 说 有 意义 的 名 称 。 一 般 来 说 ， 我 们 约定 用 origin 代表 最 接近 于 本 地 工作 的 远程 副本 ， 
而 upstrean 代表 其 他 开发 者 添加 了 最 新 功能 的 仓库 副本 ， 你 可 能 想 要 将 其 并 入 你 自己 的 
工作 中 。 
一 旦 你 设置 好 了 项 目 和 自己 仓库 副本 的 远程 连接 ， 就 应 该 验证 这 些 名 称 和 URL 是 否 符合 
你 的 预期 ， 如 下 所 示 。 


$ git remote --verbose 


我 的 操作 的 输出 如 下 所 示 。 

































































official git@gitlab.com:gitforteams/gitforteams.git (fetch) 
official git@gitlab.com:gitforteams/gitforteams.git (push) 
personal gitQgitlab.com:emmajane/gitforteams.git (fetch) 
personal gitQgitlab.com:emmajane/gitforteams.git (push) 


现在 ， 你 可 以 作为 “贡献 者 ”和 “维护 者 ”在 你 的 项 目 中 工作 。 


7.3 ”参与 开发 


在 使 用 Git 工作 时 ， 你 会 参与 四 种 主要 活动 : 完成 新 提出 的 更 改 ， 保 持 分 支 最 新 ， 审 查 提 
出 的 更 改 ， 以 及 发 布 完成 的 工作 。 在 更 新 分 支 或 试图 将 提出 的 更 改 并 入 “项 目 ” 时， 你 不 
可 避免 地 需要 解决 冲突 。 


7.3.1 构建 完美 的 提交 


有 两 种 基本 的 提交 方法 : 展示 思维 过 程 和 呈现 最 终 解决 方案 。 当 我 在 使 用 一 种 不 太 熟 悉 的 
编程 语言 时 ， 就 会 增 量 式 地 思 芳 ， 每 次 专注 于 系统 的 一 小 部 分 。 在 我 工作 时 ， 会 在 关键 点 
前 提交 我 的 工作 快照 。 这 些 快照 作为 生命 线 ， 让 我 跟踪 自己 如 何 思考 问题 。 如 果 你 阅读 过 
我 编码 时 写 下 的 提交 说 明 ， 就 能 够 轻松 地 弄 明白 我 的 想法 。 提 交 可 能 表示 小 到 15-30 分 钟 
的 工作 增 量 。 提 交 说 明 不 太 可 能 解释 我 为 什么 做 某 事 。 初 始 提交 可 能 在 代码 注释 前 包含 一 
个 文档 块 ， 概 述 我 将 要 做 什么 ， 下 一 个 提交 可 能 是 为 我 即将 构建 的 工作 而 搭建 的 脚手架 ， 
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并 且 从 那里 继续 。 比 起 每 个 提交 的 diff 中 所 显示 的 信息 ， 提 交 说 明 并 不 会 带 来 很 大 的 价值 。 


当 我 在 进行 一 个 更 有 信心 的 任务 时 ， 更 可 能 在 工作 目录 中 作出 激进 的 更 改 ， 而 不 是 微小 的 
生命 线 提交 。 然 后 ， 当 我 的 工作 结束 后 ， 我 会 审视 整体 的 变化 ， 形 成 更 小 、 相 关 的 提交 。 
这 可 以 通过 一 次 提交 一 个 更 改 的 文件 来 完成 ， 或 者 我 可 以 使 用 --patch 模式 来 进行 更 细 粒 
度 的 提交 ， 每 次 将 一 个 文件 的 补丁 片段 添加 到 斩 存 区 以 准备 提交 。 如 果 我 需要 使 用 bisect 
命令 来 挖掘 历史 ， 这 些 策划 的 提交 以 后 将 对 我 更 加 有 用 。 例 如 ， 为 了 使 用 一 个 函数 ， 它 必 
须 已 经 在 某 处 创建 ， 因 此 我 可 能 会 选择 将 函数 的 创建 和 使 用 分 隔 到 两 个 提交 ， 即 使 我 是 一 
起 写 的 。 

我 不 愿 将 这 两 种 方法 叫 作 新 手 方法 和 进 阶 方法 ， 但 这 个 说 法 确实 有 一 定 道理 。 不 同 的 源 代 
码 管理 系统 会 用 不 同 的 方式 来 表示 项 目 历史 中 的 提交 。Git 在 向 你 显示 提交 历史 记录 时 粒 
度 非常 细 ， 因 此 ， 使 用 微小 的 提交 增 量 的 思维 方式 会 带 来 混乱 且 难 以 处 理 。 这 就 是 为 什么 
我 们 说 ， 当 你 熟悉 Git 后 ， 你 会 更 有 可 能 采取 第 二 种 方法 。 

不 过 ， 你 不 必 放 弃 你 的 微小 的 提交 。 你 可 以 使 用 rebase 来 将 多 个 未 发 布 的 小 提交 组 合成 一 
份 更 像 第 二 个 版 本 的 历史 记录 。 使 用 你 希望 的 方式 工作 ， 然 后 重 构 历 史记 录 ， 使 用 有 用 的 
方式 来 储存 信息 。 

重 写 历史 记录 

是 的 ， 我 十 分 讨厌 Git 允许 你 重 写 历史 记录 ， 然 后 告诉 你 这 样 做 有 多 么 危险 。 

对 我 来 说 ， 这 像 极 了 傲慢 的 历史 记录 修正 主义 。 但 Git 使 用 这 个 模型 。 为 了 
高 效 地 使 用 Git， 我 抛 开 自己 的 成 见 ， 采 用 软件 自身 认为 的 最 佳 实践 。 我 并 
不 害怕 变 基 ， 只 是 不 喜欢 它 一 开始 的 存在 。 我 允许 你 也 不 喜欢 它 ， 但 不 喜欢 
不 是 不 去 使 用 它 的 理由 。 它 深 深 植 根 于 Git 如 何 储存 代码 历史 记录 的 元 数据 
的 原理 之 中 。 





































































































如 果 你 不 小 心 在 两 个 提交 之 间 做 了 太 多 工作 ， 也 可 以 拥有 细 粒 度 的 提交 历史 记录 。 你 已 
经 学 过 如 何 将 单个 文件 添加 到 暂 存 区 。 你 可 以 获得 更 细 的 粒度 ， 将 单个 文件 中 的 编辑 分 
配 到 多 个 提交 。 为 了 添加 文件 中 的 部 分 修改 ， 而 不 是 整个 文件 ， 请 使 用 git add --patch 
filename 这 个 命令 。 这 个 命令 将 会 逐 行人 遍历 你 的 文件 ， 询 问 你 是 否 想 要 在 正在 构建 的 提交 
中 包含 每 个 已 更 改 的 行 。 

仅 在 必要 时 重 写 历史 记录 

如 果 你 有 着 在 中 央 服 务 器 上 显示 正在 进行 的 工作 的 文化 ， 就 需要 在 变 基 你 的 
工作 时 特别 小 心 。 当 一 个 提交 变 基 后 ， 系 统 会 给 任何 更 改过 的 提交 对 象 的 元 
数据 分 配 一 个 新 的 标识 符 。 例 如 ， 如 果 你 在 更 新 一 个 分 支 ， 你 的 本 地 提交 现 
在 有 了 新 的 父 提交 并 获得 了 一 个 新 的 ID 。 如 果 你 在 试 着 清理 分 支 的 历史 ， 并 
压缩 了 两 个 提交 ， 那 么 系统 会 将 一 个 新 的 ID 分 配给 生成 的 提交 对 象 ， 即 使 

内 容 是 相同 的 ! 这 个 双重 时 间 线 可 能 会 使 Git 感到 困惑 并 导致 冲突 。 为 了 避 
免 这 些 冲突 ， 请 在 可 以 短暂 存在 的 分 支 中 使 用 交互 式 变 基 ， 如 工 单 分 支 。 
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优秀 的 提交 对 象 具有 如 下 特征 。 

。 只 包含 相关 的 代码 。 没 有 作用 域 跃迁 ,没有 “只 是 修复 了 空白 字符 的 问题 ”。 

。 遵从 项 目的 编码 标准 ， 包 含 行内 文档 。 

。 大 小 合适 。 或 许 是 100 行 代码 。 或 许 是 一 个 大 型 重 构 ， 更 改 了 一 个 函数 名 ， 以 致 1000 
行 代码 受到 了 影响 。 

。 用 最 佳 的 提交 说 明 描述 工作 〈 见 下 节 )。 

我 听 到 过 关于 提交 说 明 最 好 的 经 验 法 则 是 “不 论 付 出 什么 代价 ， 保 证 以 后 我 不 会 因为 过 去 

太 懒 而 感到 局 悔 ”。 

你 的 提交 说 明 应 该 包含 以 下 内 容 。 

。 使 用 标准 化 格式 的 简略 描述 〈 少 于 60 字 )， 以 便 检索 日 志 。 

。 一 段 稍 长 的 解释 ， 说 明 当 前 代码 为 什么 有 问题 ， 以 及 为 什么 你 的 更 改 很 重要 。 

。 关于 更 改 如 何 解 决 手头 问题 的 高 层 描述 。 

。 概述 更 改 可 能 产生 的 副作用 。 

。 所 做 更 改 的 摘要 ， 以 便 阅 读 代码 diff 时 能 够 确认 提交 说 明 。 但 阅读 diff 不 是 用 来 猪 测 所 
发 生 更 改 的 办 法 。 

。 工 单 编号 ， 或 指向 源码 的 引用 ， 提 议 的 更 改 可 以 、 已 经 或 将 要 在 其 中 进行 讨论 。 

。 谁 会 受到 这 个 更 改 的 影响 〈 例 如 针对 开发 者 的 优化 ， 或 针对 用 户 的 改进 ) 。 

。 列 出 文档 哪些 地 方 需要 更 新 。 

下 面 显示 的 是 一 个 不 好 的 提交 说 明 。 
git commit -am "rewrote entire site in angular.js - it's faster now, I'm sure" 

因为 以 下 原因 ， 这 个 提交 不 够 充分 。 

。 由 于 使 用 了 -a 参数， 所 有 文件 将 会 作为 此 提交 的 一 部 分 提交 ， 却 没有 考虑 是 否 应 该 将 
它们 纳入 这 个 提交 。 

。 由 于 使 用 了 -mn 标志， 我 们 总 是 倾向 于 编写 简要 的 提交 说 明 ， 而 不 是 具体 描述 为 什么 这 
个 更 改 是 必要 的 ， 以 及 这 个 更 改 如 何 解 决 问题 。 

。 这 个 提交 说 明 没有 3 引用 工 单 号 ， 因 此 无 法 知道 哪些 问题 现在 已 经 解决 了 ， 并 且 可 以 在 工 
单 跟踪 工具 中 关闭 。 

作为 对 比 ， 一 份 好 的 提交 说 明 应 该 如 下 所 示 。 


$ git commit 















































[#321] Stop clipping trainer meta-data on video nodes at small screen size. 
- Removes an unnecessary overflow: hidden that was causing some clipping. 
Resolves #321 
由 于 以 下 原因 ， 这 是 一 份 好 的 提交 说 明 。 


。 它 在 精简 的 提交 说 明 开头 用 方 括号 包含 了 工 单 号 ， 以 便 以 后 更 容易 地 读 取 日 志 。 
。 精简 的 描述 (用 于 精简 日 志 视 图 ) 解释 了 站 点 访问 者 看 到 的 现象 。 
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。 消息 的 说 明 解 释 了 用 于 解决 这 个 问题 的 技术 实现 。 
。 提交 消息 的 最 后 一 行 (Resolves #321) 将 会 被 工 单 系统 捕捉 到 ， 并 将 工 单 的 状态 从 “ 进 
行 中 ”(open) 移动 到 “需要 评审 ”(needs review), 


在 提出 更 改 时 ， 你 应 该 保持 提案 精简 ， 专 注 于 解决 单个 问题 。 这 将 使 项 目的 “维护 者 ” 
更 容易 地 审查 你 的 提交 ， 并 且 接 受 你 的 工作 。 例 如 ， 如 果 你 在 修复 代码 库 某 处 的 一 个 特 
4E bug， 不 要 修复 代码 其 他 地 方 多 出 来 的 一 个 行 尾 。 虽 然 项 目 可 能 有 自己 的 分 支 命 名 约 
定 ， 如 果 你 在 贡献 一 个 偶然 发 现 的 修复 ， 而 这 个 修复 还 不 是 一 个 “项 目 ” 仓 库 中 已 识别 的 
问题 ， 请 使 用 你 正在 解决 的 问题 的 精简 描述 来 命名 你 的 分 支 ， 例 如 ，css_button_padding 
(按钮 的 CSS 内 间距 ) 或 improved test coverage (提高 测试 覆盖 率 ) ( 例 7-3)。 

fj 7-3 癌 代 码 库 提 交 更 改 


$ git checkout -b terse description 
(edit files) 
































$ git add filename(s) 
$ git commit 


此 时 ， 提 交 说 明 编 辑 器 将 会 打开 ， 你 将 需要 提供 你 曾 写 过 的 最 好 的 提交 说 明 。 
当 提 议 的 更 改 准 备 完毕 后 ， 你 现在 可 以 使 用 push 命令 将 它 推送 到 你 的 仓库 副本 ， 如 下 所 示 。 
$ git push 


你 的 个 人 分 支 已 经 上 传 ， 现 在 是 和 队友 一 起 将 你 的 更 改 并 和 人 项目 主 分 支 的 时 候 了 。 


7.3.2 ”保持 分 支 最 新 

储存 在 Git 中 的 分 支 通 常 被 视 为 以 下 两 者 之 一 : 官方 的 项 目 分 支 和 短期 存在 的 建议 分 支 。 
共享 的 项 目 分 支 被 用 于 集成 由 多 个 开发 者 评审 并 通过 的 代码 ， 且 包含 项 目 代 码 的 官方 历 
史 。 你 的 这 些 分 支 的 本 地 副本 应 该 永远 保持 最 新 并 应 该 总 是 被 用 作 你 的 工 单 分 支 的 基线 分 
支 。 按 照 惯例 ， 将 新 的 更 改写 入 一 个 官方 分 支 的 本 地 副本 是 不 合适 的 。 相 反 ， 你 应 该 创建 
一 个 新 的 分 支 并 完成 你 的 工作 ， 然 后 将 那个 分 支 合 并 回 官方 分 支 。 在 第 3 章 中 我 们 讨论 了 
几 种 分 支 策略 ， 如 果 你 的 团队 还 没有 选择 一 个 分 支 策 略 ， 你 可 能 会 希望 回 过 头 再 看 看 那 一 
章 。 第 二 种 类 型 的 分 支 事 实 上 是 开发 者 的 沙 盒 。 在 其 中 你 可 以 测试 新 的 想法 ， 并 让 你 的 代 
码 为 评审 作 好 准备 。 这 些 短 期 存在 的 工作 分 支 也 必须 保持 最 新 ， 但 需要 使 用 一 个 略微 不 同 
的 方法 。 


i 






























































问题 又 来 了 ， 是 选择 变 基 还 是 合并 ? 

现 有 仍然 不 会 有 任何 变 基 警 察 突 然 出 现在 你 的 团队 会 议 上 。 你 需要 明白 ， 作 
为 一 个 团队 ， 你 们 将 如 何 解决 分 支 更 新 的 问题 。( 我 仍然 认为 你 需要 做 的 是 
对 你 的 团队 最 好 的 事 ， 但 我 将 向 你 展示 变 基 的 指示 ， 这 样 你 会 发 现 使 用 这 种 
方法 并 不 是 很 难 。) 不 管 你 使 用 哪 种 方法 ， 仔 细 记 录 你 的 解决 方案 ， 并 且 帮 
助 Git 新 手 ， 确 保 他 们 能 够 一 模 一 样 地 执行 这 些 命 令 。 我 发 现 确 保 一 致 性 最 
好 的 办 法 是 提供 方便 复制 和 粘贴 的 文档 ， 并 且 让 人 们 在 命令 行 中 工作 。 此 
外 ， 流 程 图 也 会 很 有 用 (http://gitforteams.com/resources/merge-rebase.html) 。 
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为 了 减少 合并 短期 存在 的 分 支 时 需要 处 理 的 冲突 数量 ， 你 应 该 保持 你 的 工作 分 支 与 你 即将 
并 和 的 项 目 分 支 同步 。 定期 ”是 多 和 久 ? 我 建议 你 更 新 你 的 分 支 的 频率 ， 至 少 和 你 喝 咖 啡 
的 频率 一 样 。 如 果 你 不 喝 咖 啡 ， 我 会 建议 你 至 少 每 天 使 用 例 7-4 中 的 命令 更 新 一 次 你 的 工 
作 分 支 。 是 的 ， 这 看 起 来 很 乏味 ， 但 从 长 还 来 看 ， 保 持 你 的 工作 尽 可 能 最 新 可 以 闻 省 你 很 
多 时 间 。 


例 7-4 更 新 项 目 分 支 的 本 地 副本 
$ git checkout master 
$ git pull --rebase=preserve 


Git 会 更 新 主 仓库 的 本 地 副本 来 并 入 上 游 仓库 的 更 改 。 


一 且 项 目 分 支 是 最 新 的 ， 你 现在 可 以 更 新 你 的 工作 分 支 了 。 然 而 ， 如 果 你 要 更 新 的 工作 分 
支 与 共享 的 项 目 分 支 不 同 ， 那 么 你 就 不 会 有 一 个 上 游 分 支 可 以 让 你 拉 取 更 改 。 因 此 ， 你 如 
何 知道 你 现在 是 否 应 该 合并 或 变 基 ? 经 验 法 则 如 下 : 你 刚 开始 的 工作 是 否 会 被 立刻 并 入 已 
存在 的 工作 分 支 ? 如 果 它 是 你 写 的 一 个 功能 ， 它 不 会 出 现在 你 刚刚 更 新 的 分 支 上 ， 因 此 你 
应 该 合并 这 个 分 支 来 并 入 新 的 工作 。 如 果 它 是 其 他 人 写 的 一 个 功能 ， 你 几乎 一 定 会 想 要 变 
Ak (如 有 果 你 的 团队 使 用 变 基 )。 另 一 个 有 用 的 小 技巧 是 匹配 名 称 。 如 果 你 想 要 并 入 的 更 改 
来 自 一 个 同名 但 在 不 同 远程 仓库 上 的 分 支 ， 那 么 你 几乎 一 定 想 要 变 基 。 


在 Git 中 ， 变 基 和 快 进 合 并 都 会 导致 线性 的 时 间 轴 ， 因 为 它们 重演 了 你 在 其 他 分 支 中 提交 
的 工作 。 由 于 每 个 提交 都 被 重演 了 ， 存 在 需要 你 解决 合并 冲突 的 可 能 性 。 因 此 ， 对 处 理 合 
并 冲突 不 那么 自信 的 开发 者 可 以 选择 简化 流程 ， 使 用 merge 命令 来 更 新 他 们 的 工作 。 使 用 
merge 确实 使 你 的 历史 记录 更 难 阅读 ， 但 在 技术 上 更 简单 了 ， 因 为 它 通常 涉及 更 少 的 合并 
冲突 。 
如 果 你 在 一 个 复杂 的 代码 库 上 工作 ， 能 够 快速 运行 调试 工具 非常 重要 ， 你 应 该 多 花 点 时 间 
使 用 rebase 命令 来 更 新 你 的 工作 分 支 ， 从 而 获得 一 个 干净 的 历史 记录 。 但 是 ， 如 果 觉 得 使 
贡献 尽 可 能 简单 更 为 重要 ， 你 可 能 会 希望 允许 你 的 开发 者 使 用 merge 命令 来 更 新 分 支 。( 最 
Git 的 Git 读者 在 看 到 这 里 时 会 恨 得 咬牙 切 齿 。 但 你 知道 吗 ?即使 你 的 团队 决定 想 要 更 简单 
的 方法 ， 也 不 会 有 Git 警察 突然 出 现在 你 的 门 前 。 我 保证 。 在 这 里 放 张 蜜 多 的 图 片 不 太 合 
适 ， 让 我 们 继续 讲 下 去 吧 。) 
在 更 新 你 的 工作 分 支 时 ， 你 要 做 的 第 一 件 事 是 确保 你 的 项 目 分 支 是 最 新 的 。 保 持 一 个 共享 
分 支 最 新 的 方式 通常 是 使 用 pull 命令 (使 用 可 选 参数 - -rebase)。 为 了 更 新 你 的 个 人 工作 
分 支 ， 你 需要 记 住 你 最 初 起 源 的 源 分 支 并 将 这 个 分 支 上 的 更 改 复制 到 你 的 工作 分 支 。 如 果 
你 遵循 第 3 章 中 描述 的 GitFlow 模型 ， 这 个 分 支 可 能 是 dev 或 development, 
例如 ， 如 果 你 的 工作 分 支 名 为 2378-add-test， 而 你 的 源 分 支 名 为 development， 则 命令 如 
下 所 示 。 

$ git checkout development 

$ git pull --rebase=preserve 


$ git checkout 2378-add-test 
$ git rebase development 


你 在 工作 分 支 中 做 出 的 每 个 提交 现在 将 被 重新 应 用 ， 看 上 去 来 自 development 分 支 的 新 提 
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交 一 直 就 在 那里 。 这 些 提交 可 能 会 干净 地 应 用 ， 或 者 你 可 能 需要 处 理 合并 冲突 。 因 为 变 基 是 
Git 中 更 新 分 支 首选 的 方法 ， 所 以 我 将 不 得 不 向 你 省 略 如 何 合并 分 支 的 命令 。 和 希望 你 会 原谅 我 。 
除了 保持 你 的 分 支 最 新 之 外 ， 在 你 自己 的 工作 被 并 和 人 人 “项目 ”后 ， 你 还 应 该 记得 更 新 你 的 
个 人 人 仓库， 因为“ 项目” 的 主 分 支 现在 包含 了 新 的 提交 。 当 你 负责 审查 别人 的 工作 并 将 其 
合并 到 master 分 支 时 ， 这 将 非常 有 用 。 你 允许 的 命令 与 之 前 描述 的 完全 相同 ， 如 下 所 示 。 


$ git checkout master 
$ git pull --rebase=preserve 


不 管 你 选择 如 何 更 新 分 支 ， 我 希望 你 至 少 尝试 在 工作 流 中 使 用 变 基 。 尽 管 有 时 它 会 令 你 肖 
de, 但 如 果 你 需要 使 用 第 9 章 中 描述 的 调试 技术 ， 那 么 变 基 能 够 帮助 你 获得 一 个 更 干净 的 
历史 记录 。 


7.3.8 ”评审 工作 


为 了 评审 别人 的 工作 ， 你 必须 在 你 自己 的 仓库 中 获得 一 份 该 工作 的 本 地 副本 。 这 可 能 是 已 
经 并 入 官方 项 目 分 支 中 的 工作 ， 也 可 能 是 同事 请 你 评审 并 合并 到 主 项 目的 一 个 新 功能 或 
bug 修复 。 

同行 评审 新 的 工作 是 一 个 多 步骤 的 过 程 ， 第 8 章 将 对 其 进行 更 详细 的 讨论 。 基 本 过 程 如 下 
所 示 。 

(1) 添 加 一 个 到 相关 仓库 的 远程 连接 。 

D 从 那个 仓库 中 获取 可 用 的 分 支 。 

(3) 为 你 想 要 仔细 检查 的 分 支 创建 一 份 本 地 副本 。 

(4) 将 其 他 分 支 中 你 想 要 的 更 改 并 入 你 的 工作 。 

O 将 修订 后 的 分 支 推送 回 相 关 的 远程 仓库 。 


你 要 做 的 第 一 件 事 是 找到 包含 你 想 要 并 和 人 的 工作 的 仓库 。 使 用 remote 的 子 命令 show 列 出 
每 个 远程 仓库 〈 例 7-5)。 和 列 出 分 支 一 样 ， 所 有 可 用 的 远程 都 会 列 为 命令 的 输出 。 在 例 7-5 
中 ， 我 在 上 一 节 中 添加 的 两 个 远程 显示 了 出 来 。 这 会 快速 提醒 我 想 要 深入 研究 哪个 仓库 。 


例 7-5 远程 仓库 的 精简 列表 


$ git remote show 












































































































































official 
personal 


一 旦 你 有 了 仓库 的 名 称 ， 就 可 以 在 上 个 命令 中 添加 别名 来 获得 完整 的 远程 列表 ( 例 7-6)。 
例 7-6 远程 仓库 personal 的 全 部 细节 


$ git remote show personal 





* remote personal 

Fetch URL: gitQgitlab.com:emmajane/gitforteams.git 
Push URL: git(ggitlab.com:emmajane/gitforteams.git 
HEAD branch: master 

Remote branches: 
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2-bad jokes tracked 
master tracked 
sandbox tracked 
video-lessons tracked 
Local branch configured for 'git pull': 
master merges with remote master 
Local ref configured for 'git push': 
master pushes to master (up to date) 


这 里 我 可 以 看 到 远程 仓库 中 储存 了 四 个 分 支 ， 每 个 分 支 我 在 本 地 都 有 一 个 对 应 的 副本 [由 
单词 tracked (跟踪 ) 指示 ] 。 
更 新 你 的 本 地 分 支 列表 
如 果 你 已 经 有 了 一 个 远程 仓库 的 连接 ， 而 且 没 有 看 到 你 的 同伴 让 你 评审 的 分 
支 ， 请 首先 运行 git fetch 命令 ， 确 保 远程 分 支 列表 是 最 新 的 。 


























如 果 你 不 希望 获得 所 有 关于 远程 仓库 的 信息 ， 那 么 可 以 选择 使 用 branch 命令 和 - -remotes 
参数 来 只 显示 远程 分 支 〈 例 7-7)。 这 将 使 你 能 够 定位 到 你 需要 评审 的 分 支 。 与 参数 -all 
相 比 ， 我 更 喜欢 这 个 branch 的 变种 ， 因 为 它 给 出 了 分 支 的 真名 ， 而 不 会 添加 remotes 引用 


信息 。 


£j 7-7. 列 出 远程 分 支 


$ git branch --remotes 




















分 支 是 提交 的 组 合 

分 支 是 一 个 线性 的 开发 过 程 ， 将 单个 提交 对 象 连接 起 来 。 不 同 的 分 支 实例 上 
可 能 有 不 同 开发 者 创建 的 提交 ， 在 仓库 同步 前 并 不 相同 。 这 其 实 是 一 种 混沌 
的 状态 ， 但 混沌 只 存在 于 每 个 小 仓库 中 。 作 为 软件 团队 ， 我 们 建立 的 约定 是 
为 混沌 带 来 秩序 ， 并 允许 我 们 以 一 种 理智 的 方式 共享 我 们 的 工作 。 还 记得 我 
们 在 第 3 章 中 学 到 的 分 支 策 略 吗 ?它们 将 工作 按照 逻辑 思维 流 组 织 。 还 记得 
第 2 章 中 的 权限 策略 吗 ? 它们 会 把 人 们 锁定 在 正确 的 仓库 中 ， 如 果 没 有 社区 
看 守 者 的 帮助 ， 无 法 进行 更 改 。 















































如 果 你 为 branch 命令 添加 了 - -verbose 参数 ， 分 支 顶端 的 单行 提交 说 明 将 会 被 包含 在 输出 
中 。 例 如 ， 我 有 多 个 活跃 的 工作 分 支 、 一 个 集成 分 支 和 一 个 项 目的 官方 分 支 ( 例 7-8)。 尽 
管 我 偶尔 把 我 的 提交 上 传 到 远程 服务 器 ， 大 多 数 时 候 我 只 是 在 章节 分 支 上 工作 ， 将 我 的 工 
作 并 入 集成 分 支 drafts， 然 后 并 入 主 分 支 master, 


例 7-8 在 编写 本 章 时 ，git branch --verbose 的 节选 输出 
ch02 7313755 CH02: Adding patching workflow diagram. 
ch84 69a3ded CH4: Stub file added with notes copied from Drupalize.Me. 
* ch05 80b5200 [official/ch05: ahead 2] CH05: Fixing URL for image O5fig01. 
drafts 80b5200 CH05: Fixing URL for image 05fig01. 
master 319bb53 [official/master] Merge branch 'drafts'. Updates for CH05. 




















A 
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第 一 列 包含 分 支 名 ， 第 二 列 包含 提交 ID， 第 三 列 包 含 最 新 的 提交 消息 的 首 行 。 如 果 一 个 分 
支 是 远程 跟踪 分 支 ， 远 程 分 支 的 名 称 出 现在 提交 ID 和 提交 说 明之 间 的 方 括号 中 。 

一 旦 你 找到 了 包含 你 想 要 评审 的 工作 的 远程 分 支 ， 就 可 以 将 分 支 复 制 到 你 的 本 地 仓库 ( 例 
7-9)， 或 者 使 用 log 和 diff 命令 来 检查 对 它 的 应 用 ( 例 7-10)。 


例 7-9 将 一 个 远程 分 支 复 制 到 你 的 本 地 仓库 


$ git checkout --tracking remote nickname/branch 


例 7-10 在 不 创建 工作 副本 的 情况 下 检查 一 个 远程 分 支 
$ git log --oneline remote nickname/branch 
$ git diff current branch...remote nickname/branch 


假设 工作 通过 了 审查 ， 那 么 就 该 将 它 合并 到 主 项 目 分 文 了 。 


7.3.4 合并 完成 的 工作 


在 将 新 工作 合并 到 你 的 项 目 分 支 前 ， 你 需要 确保 所 有 分 支 都 是 最 新 的 。 这 一 步 是 必要 的 ， 
因为 如 果 (远程 上 的 ) 目标 分 支 包含 不 在 你 本 地 副本 中 的 提交 ，Git 将 不 允许 你 推送 远程 
仓库 的 副本 。 

在 将 新 工作 上 传 至 远程 服务 器 时 ，Git 只 会 接受 快 进 合并 的 工作 。 这 意味 着 你 不 必 担 心 在 
推送 你 的 工作 时 遇 到 合并 冲突 。 由 于 这 个 限制 ， 你 的 本 地 分 支 需 要 包含 所 有 远程 提交 ， 然 
后 才能 推送 你 的 分 支 。 为 了 更 新 你 的 工作 ， 你 需要 使 用 pull 命令 来 获取 所 有 远程 服务 器 上 
的 更 改 ， 并 将 任何 新 工作 并 入 你 的 本 地 分 支 。 
首先 ， 使 用 带 --rebase 参数 的 putt 命令 来 更 新 你 的 目标 分 支 副 本 ( 例 7-11)。 


例 7-11 并 入 项 目 分 支 中 的 更 新 
$ git checkout master 
git pull --rebase=preserve 


$ 
在 公共 分 支 更 新 后 ， 你 还 需要 更 新 功能 分 支 ( 例 7-12)。 
$17-12. Tt—^- SEX L8 E 7 AERE 2 3€ 


$ git checkout 2378-add-test 
$ git rebase master 


最 后 ， 你 可 以 将 工 单 分 支 并 入 主 项 目 分 支 〈 例 7-13)。 
例 7-13 将 完成 的 工 单 分 支 合 并 到 公共 的 项 目 分 文 


$ git checkout master 
$ git merge --no-ff 2378-add-test 


如 有 果 所 引入 的 更 改 和 以 前 完成 的 工作 不 同 ， 则 合并 即将 完成 ， 但是， 如 果 同 一 区 域 中 有 重 
合 的 工作 ，Git 将 会 不 知道 如 何 完成 这 个 合并 ， 会 寻求 你 的 指导 。 在 Git 术语 中 ， 寻 求 帮助 
BERISH PR, MERA EITA. 
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7.9.5 解决 合并 和 变 基 冲突 

冲突 听 起 来 就 很 古 手 和 可 怕 ， 但 在 Git 中 ， 合 并 冲突 事实 上 是 一 个 非常 小 的 问题 ， 你 不 需 
要 花 很 多 钱 请 一 个 协调 人 或 者 治疗 师 来 解决 它 。 在 任何 时 候 ， 文 件 都 是 在 原 地 被 修改 的 ， 
Git 不 确定 哪个 版 本 才 是 正确 的 版 本 ， 因 此 会 请 你 来 做 这 个 决定 。Git 将 这 种 不 确定 性 称 为 
冲突 。 

当 你 合并 两 个 分 支 时 ， 总 有 可 能 出 现 这 样 的 情况 ， 我 们 和 他 们 同时 修改 了 同一 个 文件 中 的 
同 几 行 代码 。 
Git 会 在 任何 文件 的 冲突 位 置 添加 下 面 三 行 冲突 信息 。 


<<<<<<< 




















我 们 的 代码 和 他 们 的 代码 通过 一 行 = 分隔 开 来 。 为 了 解决 一 个 冲突 ， 你 将 需要 编辑 这 些 文 
件 ， 选 择 要 保留 的 正确 内 容 并 删除 标记 。 当 你 打开 文件 来 查看 冲突 时 ， 顺 便 检查 一 下 旁边 
的 区 域 。 有 时 Git 会 弄 错 应 该 放置 标记 的 地 方 ， 因 此 你 不 应 该 简单 地 删除 其 中 一 整 块 区 域 ， 
或 另 一 块 区 域 。 仔 细 阅 读 ， 当 你 看 到 下 面 的 代码 时 ， 会 发 现 你 需要 保留 每 一 块 区 域 中 的 一 
部 分 内 容 。 

<<<<<<< HEAD 


$p++; 














>>>>>>> 2378-add-test 
如 果 不 理解 这 里 代码 更 新 的 目的 ， 我 们 就 没有 足够 信息 来 解决 这 个 合并 冲突 。 或 许 右 括号 
应 该 保留 ， 因 为 它 同 时 出 现在 了 冲突 的 两 侧 ， 但 新 增 的 那 一 行 呢 ? 自 增 的 变量 呢 ? 如 果 你 
遇 到 了 不 知道 如 何 解决 的 合并 冲突 ， 无 法 直接 通过 阅读 代码 来 弄 明白 ， 你 应 该 与 代码 的 原 
作者 讨论 。 如 果 你 错误 地 解决 了 一 个 冲突 ， 误 解 代码 并 删除 了 过 多 (或 过 少 ) 代码 可 能 会 
导致 意外 地 引入 新 的 bug。 


一 步 步 解决 两 个 分 又 的 分 支 间 的 冲突 
有 一 个 辅助 程序 ，git-imerge (https://github.com/mhagger/git-imerge)， 用 于 合 
并 两 个 分 支 顶端 的 提交 。 使 用 增 量 式 提交 使 你 更 容易 看 清 冲 突 应 该 被 如 何 解 
决 ， 因 为 每 次 只 需要 更 少 的 内 容 。 这 不 是 Git 核心 的 一 部 分 ， 你 需要 单独 下 
载 并 安装 这 个 软件 。 如 果 你 想 要 减少 安装 的 麻烦 ， 请 查看 你 最 喜欢 的 包 管理 


工具 。 我 的 副本 是 通过 OS X 的 Brew (https://brew.sh/) 安装 的 。 























当 你 完成 编辑 后 ， 可 以 移 除 Git 放 到 文件 中 的 标记 ， 使 用 屏幕 上 Git 状态 说 明 提供 的 指示 
继续 操作 ， 如 下 所 示 。 
$ git status 


如 有 果 你 完成 了 一 个 合并 ， 就 需要 添加 更 新 后 的 文件 ， 并 将 它们 提交 至 你 的 仓库 ， 如 下 所 示 。 
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$ git add filename(s) 
通过 每 次 添加 一 个 文件 ， 你 可 以 将 status 命令 用 作 一 个 待 办 列表 ， 列 出 包含 合并 冲突 并 需 
要 进行 处 理 的 文件 ， 如 下 所 示 。 

$ git status 
一 旦 每 个 文件 中 的 合并 冲突 都 被 清理 完 之 后 ， 你 就 可 以 提交 你 暂 存 的 更 改 ， 如 下 所 示 。 

$ git commit 
此 时 ，Git 默认 的 文本 编辑 器 会 打开 ， 同 时 显示 关于 你 正在 完成 的 提交 的 额外 信息 。 当 你 
完成 了 说 明 的 编写 后 ， 保 存 更 改 并 退出 编辑 器 以 继续 。 
如 果 你 在 遇 到 合并 冲突 时 尝试 变 基 ， 或 许 会 进入 一 个 多 步 过 程 中 。 在 这 种 情况 下 ， 你 需要 
继续 变 基 过 程 ， 如 下 所 示 。 

$ git rebase --continue 
如 果 在 开始 合并 前 ， 你 深信 不 疑 你 想 要 全 部 使 用 引入 的 工作 〈 他 们 的 ) 或 者 你 自己 的 工作 
(我 们 的 ) ， 那 么 可 以 预先 告诉 Git 你 希望 如 何 处 理 两 个 分 支 中 的 提议 更 改 。 例 如 ， 如 果 你 
想 要 合并 一 个 分 支 ， 并 知道 其 中 包含 了 一 个 问题 的 修复 ， 就 可 以 强制 Git 使 用 另 一 个 分 支 
来 更 新 你 自己 的 分 支 ， 如 下 所 示 。 


$ git checkout branch to update 
$ git merge --strategy-option-theirs incoming branch 


7.3.6 发 布 工 作 


在 你 第 一 次 向 指定 分 支 上 传 你 的 更 改 时 ， 需 要 指明 想 要 使 用 的 远程 仓库 和 分 支 名 。 习 惯 上 
我 们 会 保持 本 地 和 远程 仓库 中 的 分 支 名 一 致 。 你 将 需要 包括 远程 仓库 的 别名 。 在 例 7-14 
中 ， 我 们 假设 远程 仓库 的 名 称 为 origin, 
例 7-14 将 包含 提议 更 改 的 分 支 上 传 至 远程 仓库 

$ git push --set-upstream origin branch 
一 旦 你 在 远程 仓库 中 建立 了 这 个 分 支 ， 就 可 以 使 用 push 命令 将 工作 再 次 上 传 到 同一 个 远程 
仓库 ， 如 下 所 示 。 

$ git push 
如 果 你 的 仓库 拥有 多 个 远程 仓库 ， 那 么 你 将 需要 显 式 地 将 更 改 分 别 推送 到 每 一 个 远程 仓 
库 。 黑 认 情 况 下 ， 我 们 使 用 origin， 如 下 所 示 。 

$ git push remote nickname 
这 个 过 程 的 下 一 步 取决 于 你 使 用 的 托管 系统 。 不 过 ， 一般 来 说 ， 前 往 “ 项 目 ” 页 面 ， 你 可 
以 在 上 面 找 到 一 个 拉 取 请 求 (pull requests). 链接 〈 这 个 表述 在 你 选择 的 系统 中 可 能 会 略 有 
不 同 )。 通 过 这 个 链接 ， 你 应 该 能 够 发 起 一 个 请 求 ， 将 你 提议 的 更 改 纳入 项 目 。 系 统 应 该 
已 经 知道 你 的 哪个 仓库 是 克隆 自 “ 项 目 ” 的 ， 并 且 应 该 列 出 你 在 副本 中 工作 过 、 可 能 包含 
“项 目 ” 提 议 更 改 的 分 支 。 你 将 选择 想 要 并 入 的 分 支 ， 并 完成 任何 其 他 所 需 的 工作 。 第 三 
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部 分 深入 讨论 了 这 个 流程 。 

一 旦 你 的 提交 请 求 提交 后 ,“ 维 护 者 ”将 审查 你 提议 的 更 新 。 他 可 能 会 按照 原样 接受 你 的 
工作 ， 或 要 求 你 修改 并 重新 提交 你 的 工作 。 如 果 需 要 其 他 更 改 ， 重 复 本 节 中 列 出 的 步骤 ， 
直到 该 拉 取 请 求 被 接受 。 

为 了 将 新 工作 发 布 到 共享 分 支 上 ， 你 要 做 的 第 一 件 事 是 检查 你 将 要 合并 的 分 支 是 否 是 最 新 
的 ， 这 将 确保 你 可 以 在 合并 更 改 后 推送 你 的 工作 。 如 果 这 个 分 支 不 是 最 新 的 ， 你 将 无 法 上 
传 这 个 共享 分 支 的 修订 副本 ， 直 到 你 下 载 了 新 更 新 并 将 其 并 入 该 分 支 为 止 ， 如 下 所 示 。 


$ git checkout master 
$ git pull --rebase=preserve 


在 你 的 主 项 目 分 支 的 本 地 副本 更 新 之 后 ， 你 应 该 确保 这 些 更 改 被 同时 复制 到 你 所 在 的 功能 
分 支 中 ， 使 得 在 执行 合并 之 前 两 个 分 支 的 差异 最 小 ， 如 下 所 示 。 


$ git checkout 2378-add-test 







































































$ git rebase master 

在 工作 分 支 更 新 后 ， 你 可 以 合并 已 通过 评审 且 被 接受 的 更 改 ， 如 下 所 示 。 
$ git merge --no-ff 2378-add-test 
$ git push 


现在 ， 你 可 以 从 你 的 本 地 仓库 和 任何 你 拥有 写 入 权限 的 远程 仓库 中 删除 这 个 工作 分 支 ， 如 
下 所 示 。 


$ git branch --delete 2378-add-test 
$ git push remote nickname --delete 2378-add-test 


你 的 分 支 现在 应 该 已 是 最 新 ， 可 供 你 的 同事 下 载 。 


接 下 来 发 生 的 事情 很 大 程度 上 取决 于 你 正在 构建 的 软件 类 型 。 想 要 连接 Git 和 持续 集成 
构建 服务 器 的 Web 开发 者 将 会 受益 于 Lorna Mitchell 的 视频 Git Fundamentals for Web 
Developers (http://shop.oreilly.com/product/0636920042129.do) 


7.4 样 例 工作 流 


本 章 剩余 部 分 是 与 团队 一 起 工作 时 的 模板 。 你 应 该 与 你 的 团队 讨论 他 们 想 要 如 何 工 作 ， 并 
写 下 每 个 贡献 者 和 维护 者 在 项 目 期 间 需 要 使 用 的 命令 。 


7.4.1 基于 冲刺 的 工作 流 


这 个 流程 与 我 在 多 个 基于 冲刺 发 布 周期 的 团队 中 使 用 的 流程 基本 相同 。 这 是 一 个 GitFlow 
的 变 体 ， 适 用 于 网 站 的 每 周 部 署 。 冲 刺 的 安排 遵从 单 周 (相对 于 更 “传统 ”的 双 周 冲刺 )。 
这 会 鼓励 细 粒 度 的 工 单 并 帮助 开发 者 尽快 在 产品 中 看 到 他 们 的 工作 。 如 有 果 一 些 工 单 范围 较 
广 ， 它 们 可 能 需要 在 几 个 “冲刺 ”中 完成 。 

























































































仓库 设置 有 五 种 不 同类 型 的 分 支 : 开发 分 支 、 工 单 分 支 、QA 分 支 、 主 分 支 和 补丁 分 文 
( 表 7-1)。 这 些 分 支 要 么 用 作 单 个 问题 的 开发 分 支 ， 要 么 用 作 集 成 分 支 。 


表 7-1: 每 周 部 署 工作 流 中 的 分 支 类 型 






















































































分 支 名 /约定 分 支 类 型 ”描述 基线 分 支 
dev 集成 用 于 放置 通过 同行 评审 的 代码 工 单 分 支 
ticket&-descriptive-name FR 用 于 完成 工 单 中 标识 的 工作 dev 
qa 集成 用 于 每 个 冲刺 结束 前 的 质量 保证 测试 ，dev 

没有 通过 QA 测试 的 代码 会 从 这 个 分 支 

上 移 除 

master 集成 用 于 部 署 测试 全 部 通过 的 代码 qa 
hotfix-ticket£-description 开发 用 于 为 产品 中 发 现 的 紧急 问题 开发 对 策 master 上 最 新 的 发 布 


对 于 开发 者 来 说 ， 每 天 都 是 开发 日 。 此 外 ， 每 周 有 三 天 所 有 团队 成 员 为 同一 个 目标 奋斗 。 


对 开发 者 来 说 ， 这 个 工作 流 并 没有 过 于 复杂 ( 例 7-15) : 所 有 的 工作 都 始 于 一 个 全 新 的 、 
继承 自 父 分 支 dev 的 工 单 分 支 。 一 旦 完成 后 ， 工 单 分 支 中 的 工作 被 推送 到 共享 项 目 仓库 。 
分 支 通过 变 基 保 持 最 新 ， 与 合并 相 比 ， 你 会 得 到 一 个 更 干净 的 分 支 历 史记 录 。 


例 7-15 完成 工 单 时 需要 的 Git 命令 
在 这 个 例子 中 ， 用 远程 的 名 称 替换 origin, HT AD XH ER e 1234-new_ticket_ 
branch， 如 下 所 示 。 

$ git checkout dev 

$ git pull --rebase=preserve origin dev 

$ git checkout -b 1234-new ticket branch 

// 完成 工作 

$ git add --all 

$ git commit 


在 共享 工作 前 ， 确 保 该 分 支 包 含 了 新 的 提交 ， 如 下 所 示 。 


$ git checkout dev 

$ git pull --rebase-preserve 

$ git checkout 1234-new ticket branch 
$ git rebase dev 


最 后 ， 与 其 他 人 共享 新 的 工作 ， 如 下 所 示 。 

$ git push origin 1234-new ticket branch 
在 完成 后 ， 工 单 分 支 会 由 团队 中 另 一 个 人 评审 〈 例 7-16)。 如 果 代码 通过 了 评审 ， 评 审 者 
将 工 单 分 支 合并 到 开发 分 支 并 从 主 仓库 中 删除 这 个 工 单 分 支 。 第 8 章 中 深入 讨论 了 这 个 评 
审 过 程 。 
例 7-16 完成 同行 评审 时 需要 的 Git 命令 


$ git checkout dev 
$ git pull --rebase=preserve 
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Di 


$ git checkout 1234-new ticket branch 

// 进行 评审 工作 

$ git merge --no-ff 1234-new ticket branch master 
$ git branch --delete 1234-new ticket branch 

$ git push --delete origin 1234-new ticket branch 


量 保证 (周一 至 周二 ) 的 工作 内 容 如 下 所 示 。 


dev 分 支 上 运行 着 自动 化 的 测试 集 ， 用 于 捕获 新 加 入 的 功能 分 支 中 可 能 引入 的 任何 回归 。 
dev 分 支 上 的 所 有 工作 都 被 合并 到 ga 分 支 进行 测试 〈 例 7-17)。 开 发 工作 在 dev 分 支 上 
继续 。 

在 共享 文档 (如 Google Docs) 中 创建 一 份 冲 刺 列表 ， 将 并 入 ga 分 支 的 工 单 中 的 用 户 故 
事 复制 到 文档 中 。 一 般 来 说 ， 这 是 工 单 描述 的 第 一 行 ， 你 应 该 采用 这 个 约定 来 加 速 QA 
的 流程 。 

所 有 团队 成 员 有 义务 完成 共享 文档 中 工 单列 表 的 测试 。 除 了 每 周 的 工 单 之 外 ， 可 能 还 需 
要 有 人 来 完成 滚动 更 新 的 测试 。 

为 任何 没 能 通过 质量 保证 测试 的 问题 创建 一 个 新 的 工 单 ， 使 它 可 以 在 发 布 前 进行 修复 、 
撤销 ( 例 7-18)。 

































































例 7-17 设置 ga 分 支 时 需要 的 命令 


$ git checkout dev 

$ git pull --rebase=preserve 
$ git checkout ga 

$ git merge --no-ff dev 

$ git push 


例 7-18 移 除 在 发 布 前 没 能 通过 QA 的 工 单 时 需要 的 命令 


发 


$ git log --oneline --grep ticket-number 


(找到 需要 撤销 的 提交 ) 
$ git revert commit 


$ git revert --mainline 1 merge commit 
(但 是 ,在 理想 情况 下 ,你 应 该 使 用 - -no-ff 合 并 工作 分 支 ,这 样 会 产生 一 个 便于 撤销 的 提交 ID) 
布 日 (周三 ) 的 工作 内 容 如 下 所 示 。 
qa 分 支 被 合并 到 master 分 支 并 添加 标签 ( 例 7-19)。 
在 线 上 更 新 仓库 ， 使 用 为 发 布 准备 的 带 标签 的 提交 。 
为 开发 团队 下 周 的 工作 安排 优先 级 。 



































例 7-19 准备 部 署 时 需要 的 命令 


$ git checkout master 

$ git merge ga 

$ git tag 

(找到 最 新 的 标签 ,以 确定 下 一 个 标签 的 编号 ) 


$ git tag --annotate -m tag name 
$ git push --tags 


在 标签 添加 之 后 ， 它 通过 --annotate 参数 签署 ， 通 过 -m 参数 添加 说 明 。 这 确保 了 这 个 标 





A 


140 | 第 7 章 


签 不 会 被 包 略 。 
公布 日 〈 周 四 ) 的 工作 内 容 如 下 所 示 。 


。 向 社区 用 户 公布 前 一 天 上 线 的 更 改 。 多 出 的 一 天 使 得 团队 有 机 会 处 理 代 码 移动 到 生产 环 
境 后 出 现 的 意外 回归 或 bug。 
。 在 前 一 天 新 建 的 优先 事项 列表 上 继续 开发 。 


如 果 出 现 了 不 太 可 能 发 生 的 情况 ， 一 个 严重 的 bug 或 回归 被 引入 了 生产 环境 后 ， 一 个 补丁 
随 之 产生 。 当 然 了 ， 严 重 是 一 个 相对 的 词 。 在 这 个 系统 中 ， 每 周 进行 一 次 部 署 ， 而 补丁 一 
般 无 法 等 到 一 周 才 进行 部 署 。 

每 次 部 署 都 被 打上 了 标签 ， 因 此 你 的 第 一 步 是 获取 全 部 标签 列表 ， 并 定位 到 代码 库 中 当前 
活跃 的 版 本 〈 例 7-20)。 从 此 处 创建 一 个 新 的 分 支 ， 应 用 更 新 的 代码 ， 并 在 部 署 前 上 传 ， 
等 待 评审 。 


例 7-20 创建 补丁 分 支 时 需要 的 命令 
$ git checkout master 
$ git tag 
(查看 标签 列表 ,确定 当前 活跃 的 标签 ) 

































































$ git checkout -b hotfix-issue-description tag name 


接 下 来 ， 补 丁 分 支 将 被 当 作 人 常规 的 开发 分 支 一 样 对 待 ， 经 过 同行 评审 和 质量 保证 测试 。 当 
测试 通过 后 ， 它 会 被 立即 合并 回 master 分 支 并 打上 标签 准备 发 布 〈 例 7-21). 


例 7-21 准备 补丁 的 部 署 时 需要 的 命令 


$ git checkout master 

$ git merge --no-ff hotfix-issue-description 
$ git tag --annotate -m new tag name 

$ git push --tags 


在 这 个 系统 中 ， 没 有 使 用 语义 化 的 版 本 命名 。 相 反 ， 标 签名 称 是 使 用 格式 «launch | 
version». S LEM: week».«hotfix» 进行 递增 的 。 例 如 ，1.4.3 将 会 被 用 于 表示 开发 中 第 四 周 
的 第 三 个 补丁 〈 换 名 话说 : 这 个 团队 这 周 糟 透 了 ! )。 


7.4.2 ”没有 同行 评审 的 可 信 开 发 者 

在 写 这 本 书 时 ， 我 使 用 的 是 O'Reilly 的 自动 化 构建 工具 Atlas. (https://atlas.oreilly.com/)。 
这 个 系统 还 提供 了 一 个 网 页 ， 使 得 编辑 可 以 直接 在 上 面 操作 图 书 文件 ， 保 存 的 文件 被 立即 
提交 到 master 分 支 。 界 面 上 没有 同行 评审 流程 ， 因 为 我 的 团队 中 任何 人 都 可 以 直接 编辑 一 
份 文件 。 然 而 ， 我 偏好 在 本 地 工作 ， 而 不 是 通过 网 页 。 最初 ， 我 一 直 在 master 上 工作 ,本 
地 的 分 支 开 销 很 低 。 直 到 一 次 出 现 的 合并 冲突 改变 了 我 在 本 地 的 工作 方式 。 


当 我 想 要 更 新 我 的 工作 时 ， 我 会 使 用 fetch 命令 来 查看 我 的 编辑 做 出 的 修改 。 通 过 fetch 
令 ， 我 将 我 的 master 分 支 的 副本 与 他 们 的 master 分 支 的 副本 (origin/master) 相 比 较 。 
假设 我 同意 编辑 做 出 的 所 有 修改 ， 我 会 把 他 们 的 分 支 副 本 并 入 我 本 地 的 副本 ， 如 果 我 有 异 
X, 我 会 使 用 策略 ours， 即 丢掉 他 们 的 修改 ， 但 是 让 Git 以 为 这 两 个 分 支 已 是 最 新 ， 如 下 
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所 示 。 


$ git checkout master 
$ git fetch origin 
$ git diff origin/master 


根据 我 是 否 想 要 保留 这 些 更 改 ， 我 会 使 用 三 种 方法 之 一 来 合并 工作 : 合并 所 有 工作 、 用 他 
们 的 工作 覆盖 我 的 或 用 我 的 工作 覆盖 他 们 的 。 


若 想 合并 所 有 工作 (真正 的 合并 )， 请 执行 以 下 命令 。 

$ git merge origin/master 

若 想 保留 我 自己 的 工作 ， 请 执行 以 下 命令 。 

$ git merge -X ours origin/master 

若 想 舍弃 我 自己 的 工作 ， 以 满足 评审 者 的 要 求 ， 请 执行 以 下 命令 。 
$ git merge -X theirs origin/master 


你 可 以 在 提交 层面 完成 合并 ， 抑 或 在 出 现 合并 冲突 时 ， 你 还 可 以 使 用 合并 工具 对 层面 的 合 



























































系统 的 限制 ， 你 无 法 在 单独 的 分 支 中 讨论 提议 的 更 改 。) 根据 提交 的 粒度 ， 我 或 许 还 会 选 
择 拣选 一 些 想 要 保留 的 提交 ， 并 丢弃 其 他 提交 。 第 6 章 讨 论 了 拣选 提交 。 


最 后 ， 我 会 将 本 书 的 新 版 本 上 传 至 仓库 ， 并 更 新 我 本 地 的 工作 分 支 drafts， 代 码 如 下 所 示 。 


$ git push origin master 
$ git checkout drafts 
$ git rebase master 


然后 你 开始 收 到 PDF 格式 的 评审 意见 ， 我 又 一 次 意识 到 ， 我 还 有 另 一 种 分 离 工 作 的 方 
式 。 我 想 要 新 写 一 章 ， 并 保持 这 些 提交 干净 整洁 ， 但 有 了 时候 我 一 章 正 写 到 一 半 ， 进 来 了 一 
份 编辑 修改 ， 我 希望 及 时 处 理 。 与 其 混杂 这 些 提 交 ， 我 设置 了 如 下 的 分 支 结 构 : master, 
drafts， 以 及 每 章 单独 的 一 个 分 支 ， 如 下 所 示 。 

$ git checkout ch04 

// 编写 这 一 章 

$ git add ch04.asciidoc 

$ git commit 

$ git checkout drafts 

$ git merge ch04 


drafts 分 支 让 我 整合 我 正在 进行 的 所 有 工作 。 它 通过 合并 已 完成 的 章节 来 保持 同步 ， 或 是 
在 编辑 进行 修改 后 变 基 master 分 支 。 当 我 自己 编写 章节 ， 没 有 其 他 人 的 贡献 时 ， 多 分 支 会 
产生 高 昂 的 维护 成 本 ， 但 当 越 来 越 多 的 贡献 者 开始 提供 不 同类 型 的 贡献 时 ， 更 细 的 分 支 粒 
度 使 我 能 够 选择 如 何 更 新 我 的 稿子 。 


7.4.3 ”需要 独立 质量 保证 的 不 可 信 开 发 者 
如 果 你 的 团队 中 大 多 数 都 是 可 信 的 开发 者 ， 但 也 有 一 些 合约 雇员 ， 你 可 能 会 希望 你 的 合约 





















































142 | 第 7 章 


雇员 在 派生 仓库 中 工作 ， 而 不 是 授予 他 们 主 项 目的 写 和 权限。 在 一 些 类 型 的 软件 中 ， 甚 至 
你 的 员工 之 间 也 有 这 样 的 分 割 。 例 如 ， 如 果 你 在 为 一 个 医疗 设备 开发 国 件 ， 你 可 能 需要 遵 
守 非 常 严格 的 政府 规定 ， 限 制 工 作 雇员 的 权限 提交 ， 在 工作 添加 至 仓库 前 确保 评审 的 执行 。 
这 个 模型 与 本 章 前 面 描述 的 “贡献 者 ”( 而 不 是 “维护 者 ”) 的 模型 相同 。 

第 二 个 例子 是 在 第 2 音 的 派生 策略 的 描述 中 给 出 的 。 这 里 我 包含 了 一 个 如 何 为 reveal.js 项 
目 提 交 补 丁 的 描述 。 为 此 ， 我 派生 了 一 个 项 目 ， 然 后 克隆 项 目 ， 以 便 我 可 以 在 我 的 工作 站 
辑 文件 。 然 后 ， 我 调转 方向 ， 通 过 推送 上 传 我 的 工作 ， 然 后 发 起 一 个 拉 取 请 求 来 提交 评 
审 ， 以 将 我 的 更 改 推送 回 原始 项 目 。 


根据 你 目前 读 到 的 内 容 ， 将 这 些 工作 流 所 需 的 命令 放 到 一 起 。 提 示 : 在 本 章 中 ， 你 已 经 读 
完了 所 有 内 容 。 首 先 ， 自 己 画 一 张 图 ， 然 后 添加 箭头 来 显示 整个 过 程 中 工作 的 推进 。 最 
后 ， 在 每 个 箭头 上 加 上 Git 命令 。 


7.5 1M 


在 开始 一 个 新 的 项 目前 ， 你 必须 首先 决定 项 目的 治理 结构 。 这 将 告诉 开发 者 ， 他 们 是 需要 
创建 一 份 项 目的 远程 克隆 ， 还 是 只 需要 一 份 本 地 克隆 。 消费 者 ” “贡献 者 ”和 “维护 者 - 
的 设置 权限 可 能 会 组 织 他 们 进行 一 些 任 务 ， 然 而 ， 通 过 添加 远程 仓库 连接 ， 你 可 以 轻松 地 
将 一 个 “开发 者 ”提升 为 “维护 者 ”。 
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准备 评审 





在 我 长 大 的 过 程 中 ， 我 从 父母 那里 学 到 了 两 种 评价 的 方式 。 父 母 的 回应 总 是 可 以 预料 的 。 
其 中 一 位 给 你 一 大 堆 赞扬 的 评价 ， 而 有 着 旦 家 艺术 学 院 学 位 的 另 一 位 则 会 用 设计 评判 的 标 
准 来 要 求 我 。 我 实话 告诉 你 ， 这 一 天 我 既 渴 望 又 害怕 评审 过 程 。 

不 季 的 是 ， 开 发 者 在 学 校 中 几乎 没有 接触 过 同行 评审 过 程 。 一 般 的 评审 过 程 是 将 作业 的 最 
终 稿 交 给 导师 ， 而 并 没有 留 出 讨论 如 何 改进 的 余地 。 这 种 方法 设 有 教会 学 生根 据 反馈 不 断 
提升 。 刚 开始 工作 的 毕业 生 可 能 会 默默 地 嘲笑 身边 粗制滥造 的 工作 却 不 加 以 评价 ， 以 至 于 
已 经 来 不 及 做 出 更 改 。 
完成 一 次 同行 评审 是 非常 耗 时 的 。 在 我 引入 强制 同行 评审 的 最 后 一 个 项 目 中 ， 我 们 预计 每 
个 工 单 需 要 两 倍 的 时 间 来 完成 ， 对 于 开发 者 来 说 ， 它 带 来 了 更 多 的 上 下 文 切换 ， 在 等 待 代 
码 评审 时 保持 分 支 同 步 也 是 带 来 困惑 的 根源 。 然 而 ， 它 的 回报 是 丰厚 的 。 初 级 程序 员 可 以 
接触 到 代码 库 中 更 多 的 代码 ， 而 不 只 是 他 们 正在 进行 的 那 部 分 工作 。 资 深 开 发 者 有 更 多 的 
机 会 来 质询 代码 库 中 可 能 影响 到 未 来 工作 的 决策 ， 通 过 采用 及 时 的 同行 评审 过 程 ， 我 们 市 
省 了 每 个 冲刺 最 后 的 人 工 质 量 保证 测试 所 需 的 时 间 。 我 们 认为 这 些 好 处 值得 你 投入 时 间 。 


Sa m 3E 

8.1 评审 类 型 
在 项 目 生 命 周期 中 ， 应 该 进行 儿 种 类 型 的 评审 。 尽 管 本 章 大 部 分 内 容 集 中 于 同行 代码 评 
审 ， 但 你 也 应 该 了 解 其 他 类 型 的 评审 ， 确 保 你 没有 过 早 (或 过 晚 ) 评价 项 目的 各 个 方面 。 
以 下 是 一 些 评审 类 型 。 
。 设计 评判 

通常 开发 者 不 参与 项 目的 这 个 阶段 。 然 而 ， 听 取 开 发 者 的 意见 或 许 会 导致 用 户 界面 微 

调 ， 从 而 极 大 地 降低 构建 的 难度 。 
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技术 架构 评审 

关于 即将 构建 的 底层 代码 的 同行 评审 。 在 这 个 阶段 中 ， 开 发 者 应 该 确保 数据 模型 已 经 完 
成 ， 且 易于 对 接 构 建 的 所 有 部 分 ， 可 能 还 有 未 来 的 功能 。 

自动 化 自 检 

类 似 于 拼写 检查 ， 但 是 自动 化 自 检 是 为 代码 而 设计 。 自 动 化 的 自 检 使 得 开发 者 确保 他 们 
的 代码 遵循 了 项 目的 编码 标准 。 你 可 能 有 其 他 测试 集 要 运行 。 这 种 类 型 的 评审 目的 是 为 
了 所 有 机 器 能 够 轻易 自动 化 检查 并 捕捉 住 问 题 的 评审 ， 而 不 是 浪费 时 间 执 行人 工 检查 。 
基于 工 单 的 同行 代码 评审 

本 章 大 部 分 内 容 将 会 用 于 讨论 这 种 类 型 的 评审 。 

质量 保证 / 用户 验 收 测试 
在 代码 评审 之 后 ， 新 功能 将 被 合并 到 开发 分 支 ， 并 交 由 人 类 测试 员 测 试 。 这 个 用 户 界面 
评审 通常 在 专门 的 非 生产 服务 器 上 进行 。 































































































8.2 评审 者 类 型 
根据 你 的 项 目 规模 ， 你 可 能 使 用 下 列 儿 种 评审 过 程 之 一 的 变 体 (或 者 多 种 过 程 的 组 合 )。 


同行 评审 

我 们 完全 平等 地 审查 代码 并 将 它 纳 入 项 目 。 我 们 互相 学 习 ， 在 知道 同行 会 随后 评价 自己 
的 工作 之 后 尽 我 们 所 能 来 完成 它 。 

自动 化 的 把 门人 

我 们 的 代码 有 着 测试 覆盖 率 。 我 们 相信 我 们 的 测试 ， 并 且 只 提交 我 们 认为 会 通过 大 多 数 
测试 集 的 工作 。 一 般 来 说 ， 我 们 在 代码 进入 测试 集 (准备 自动 化 部 署 ) 之 前 ， 会 听取 别 
人 的 意见 。 

共识 的 牧羊 人 

我 们 的 程序 员 社 区 是 警觉 、 有 主见 的 。 在 将 代码 标记 为 通过 社区 评审 之 前 ， 我 们 需要 利 
益 干 系 人 之 间 形 成 共识 。 我 们 或 许 还 可 以 在 社区 中 加 入 一 个 测试 机 器 人 ， 让 人 类 程序 员 
知道 什么 时 候 需 要 修改 以 满足 最 低 的 要 求 。 

仁 总 的 独裁 者 

我 的 代码 我 做 主 。 欢 迎 你 提交 你 的 建议 ， 但 我 或 者 我 的 同事 会 仔细 评审 你 的 工作 。 我 享 
受 寻 找 你 的 错误 的 过 程 ， 并 可 以 拒绝 你 的 工作 。 只 有 完美 才 足 够 好 。 















































同行 评审 不 应 该 只 受 限于 团队 中 相同 等 级 的 成 员 。 它 适用 于 不 同 技能 水 平 的 组 合 ( 表 


8- 





1)， 获 益 将 会 有 所 不 同 。 


表 8-1: 初级 评审 者 和 资深 评审 者 获得 的 收益 











初级 评审 者 资深 评审 者 
初级 评审 者 。 寻找 bug， 遵 循 标准 学 会 阅读 优秀 的 代码 ， 建 议 如 何 精简 ， 











接触 到 完整 的 代码 库 


资深 评审 者 。” ”建议 新 的 技术 ， 改善 架构 改善 架构 ， 跨 功能 团队 (接触 更 多 代码 ) 
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8.3 用 于 代码 评审 的 软件 


本 章 中 概述 的 命令 可 以 用 于 任何 Git 托管 系统 。 代 码 托管 系统 的 详细 说 明 在 第 三 部 分 中 概 
术 ， 包 括 使 用 GitHub (第 10 3£), Bitbucket (第 11 Æ) 和 GitLab (第 12 章 ) 的 说 明 。 这 
些 系统 通过 拉 取 请 求 (pull request) 或 合并 请 求 (merge request). 来 管理 代码 审查 功能 ， 而 
这 些 功能 相对 轻 量 ， 使 其 易于 使 用 并 集成 到 大 多 数 工作 流 中 。 


如 果 由 于 行业 规定 ， 你 的 汇报 要 求 更 加 严格 ， 那 么 你 可 能 需要 考虑 使 用 更 正式 的 代码 审查 
和 签发 流程 。 下 面 的 软件 包 专 注 于 代码 评审 和 签发 。 它 们 适用 于 超大 型 软件 项 目的 代码 评 
审 ， 可 能 超出 了 一 般 项 目的 需要 。 
e Gerrit. (https://www.gerritcodereview.com/) 
用 于 Android, OpenStack 和 Typo3， 这 个 评审 系统 尤其 适合 非常 大 的 项 目 。Dave 
Borowitz 有 一 个 很 不 错 的 关于 它 的 设计 (和 缺点 ) 的 视频 演讲 (http//git-merge.com/ 


videos/git-at-google-dave-borowitz.html ) 。 




















































































































e Review Board (https://www.reviewboard.org/) 
用 于 LinkedIn, Apache 软件 基金 会 和 Yeljp， 这 个 软件 提供 了 代码 何 时 在 代码 库 中 移动 
的 额外 信息 。 
除了 手动 的 代码 同行 评审 之 外 ， 它 还 能 帮助 开发 者 进行 自动 化 测试 ， 在 发 起 同行 评审 请 
求 之 前 检查 他 们 的 工作 。 一 些 开 源 项 目 ， 如 Drupal， 使 用 工具 来 验证 代码 遵守 了 编码 
规范 Coder (https:/www.drupal.org/project/coder)。 还 有 一 些 付 费 服务 ， 如 面向 Ruby 的 
PullReview (https://www.pullreview.com/) 和 Wi 向 JavaScript 的 bitHound (https://www. 
bithound.io/) ， 它 们 特定 于 语言 ， 但 与 项 目 无 关 。 


虽然 我 们 专注 于 技术 代码 评审 ， 但 越 来 越 多 的 非 技术 评审 员 正 通过 定制 的 、 按 需 的 构建 服 
务 器 加 入 评审 的 环节 。 一 个 公开 的 例子 是 Drupal 的 SimplyTest.Me (https://simplytest.me/) 
服务 。 这 个 平台 允许 人 们 一 次 用 30 分 钟 来 部 署 一 台 测 试 机 器 ， 其 中 包含 特定 的 代码 补 
了 丁 ， 这 样 他 们 就 可 以 评审 Drupal issue 队列 中 的 提议 更 改 。 这 些 构建 服务 器 也 可 以 使 开发 
人 员 受 益 。 审 查 者 不 必 一 个 个 地 进行 评审 ， 而 可 以 同时 启动 多 个 评审 所 需 的 构建 流程 。 现 
在 评审 者 可 以 通过 同时 运行 所 有 需要 完成 的 评审 的 构建 过 程 ， 以 避免 为 每 个 需要 完成 的 代 
码 评审 构建 本 地 环境 所 需 的 (有 了 时 会 很 元 长 ) 过 程 。 如 果 这 点 听 上 去 很 吸引 你 ， 你 应 该 阅 
读 Lullabot 的 文章 “使 用 拉 取 请 求 构建 工具 ”(https:/www.Iullabot.comyarticles/github-pull- 
request-builder-for-drupal), 。 如 果 你 的 技术 栈 与 他 们 有 些 不 同 ， 在 网 页 中 搜索 “ 拉 取 请 求 构 
建 工具 ”应 该 能 为 你 指出 正确 的 方向 。 



































































































































8.4 评审 issue 


在 开始 本 地 的 代码 评审 流程 之 前 ， 你 应 该 在 团队 的 issue 跟踪 工具 中 仔细 阅读 提议 更 改 的 
说 明 ， 以 了 解 提议 这 个 更 改 的 原因 。 这 是 一 个 bug 修复 吗 ? 软件 遇 到 了 什么 问题 ? 它 增 加 
了 一 个 新 的 功能 吗 ? 这 个 功能 能 够 〈 以 何 种 方式 ) 帮助 到 谁 ? 在 你 看 代码 之 前 理解 这 些 问 
题 将 会 帮助 你 在 必要 的 时 候 回 答 “ 这 个 代码 是 解决 这 个 问题 的 最 好 方法 吗 ” 这 个 问题 。 
































探索 你 的 代码 托管 平台 

大 多 数 代码 托管 系统 还 提供 一 个 Web 界面 ， 允 许 你 轻松 地 在 线 评审 提议 的 更 
改 。 在 设置 你 的 本 地 环境 之 前 ， 使 用 这 个 界面 快速 评审 代码 。 例 如 ， 如 果 提 
议 的 更 改 只 是 添加 缺少 的 一 行 代码 注释 ， 或 者 修复 一 个 拼写 错误 ， 你 可 以 在 
线 评 审 这 些 提议 的 更 改 ， 而 无 需 将 所 有 内 容 下 载 到 你 的 本 地 环境 。 

















一 旦 你 对 代码 的 作用 有 了 很 好 的 理解 ， 那 么 是 时 候 设 置 你 的 本 地 开发 环境 了 ， 以 便 你 可 以 
复 现 “过 去 ”的 状态 。 换 句 话 说， 如果 这 是 一 个 bug， 你 应 该 确 保 你 可 以 在 你 :的 测试 环境 
中 复 现 这 个 bug。 如 果 这 是 一 个 新 功能 ， 你 应 该 确定 这 个 功能 尚 不 存在 不过， 两 个 人 不 
太 可 能 会 去 实现 完全 相同 的 新 功能 )。 
评审 别人 工作 的 第 一 步 是 验证 代码 目前 是 怎么 工作 的 。 如 果 你 在 测试 一 个 特定 bug 的 修 
复 ， 这 意味 着 你 应 该 从 复 现 这 个 bug 开始 ， 这 是 你 唯一 能 够 确定 新 的 代码 修复 了 这 个 问题 
的 方法 ， 而 不 是 因为 不 同 的 环境 导致 问题 看 起 来 消失 了 。 当 你 应 用 新 的 代码 时 ， 还 希望 能 
够 捕捉 到 所 有 可 能 引入 的 回归 或 问题 。 只 有 你 确信 问题 是 由 你 刚 应 用 的 代码 引入 的 ， 才 可 
以 这 样 做 。 

设置 好 环境 并 确认 代码 的 当前 状态 后 ， 你 现在 可 以 签 出 一 份 需要 查看 的 代码 的 副本 。 


8.5 ”应 用 提议 更 改 


在 第 2 章 中 ， 你 了 解 过 几 个 不 同 的 Git 访问 控 制 模型 。 你 的 项 目 设置 或 许 有 所 不 同 ， 提 议 
评审 分 支 可 能 位 于 主 项 目 仓库 中 (8.5.1 节 ) 中 ， 也 可 能 位 于 一 个 派生 的 项 目 仓库 的 副本 中 
(8.5.2 节 )。 由 于 初始 设置 的 指令 不 同 ， 因 此 请 跳 到 与 你 相关 的 部 分 。 


8.5.1 共享 仓库 的 设置 
如 果 你 在 一 个 共享 仓库 中 工作 ， 那 么 你 的 设置 过 程 非常 简单 。 只 要 更 新 你 的 本 地 分 支 列表 
即 可 ， 如 下 所 示 。 

$ git fetch 
如 果 你 拥有 超过 一 个 远程 ， 那 么 或 许 需要 显 式 指定 你 想 要 更 新 的 远程 的 名 称 。 假 定 你 想 要 
更 新 的 远程 的 名 称 为 origin， 那 么 命令 会 如 下 所 示 。 

$ git fetch origin 
如 果 你 使 用 自动 化 构建 环境 ， 那 么 或 许 需要 显 式 拉 取 你 想 要 评审 的 分 支 (如 果 你 在 本 地 没 


有 远程 仓库 的 完整 历史 记录 )。 使 用 你 的 远程 名 称 替 换 origin， 并 用 你 想 要 评审 的 分 支 名 
称 替 换 61524-broken-Llink， 如 下 所 示 。 


$ git fetch origin 61524-broken- link:61524-broken- link 




































































第 三 个 参数 61524-broken-link:61524-broken-link 是 一 个 引用 规格 (refspec)， 将 远程 分 
支 的 名 称 映射 到 一 个 本 地 分 支 的 名 称 ([remote_branch_name]:[LocaL_branch_name])。 根 
据 约 定 ， 远 程 和 本 地 的 分 支 名 称 相 同 ， 以 便 记 忆 ， 但 它 让 分 支 名 重复 了 两 遍 ， 确 实 让 命令 
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看 上 去 更 加 复杂 。 
现在 ， 你 可 以 继续 学 习 8.5.3 市 。 


8.5.2 派生 仓库 的 设置 
有 两 种 方法 可 以 处 理 派 生 仓库 的 场景 。 第 一 种 方法 是 克隆 一 份 包含 提议 分 支 的 新 的 远程 仓 
库 副 本 。 如 果 我 们 正在 评审 过 程 中 ， 并 且 不 负责 将 提议 的 更 改 合并 回 主 项 目 仓库 ， 那 么 这 
种 方法 是 合适 的 。 第 二 种 方法 是 在 我 们 自己 的 本 地 仓库 中 添加 一 个 新 的 远程 仓库 ， 并 将 更 
改 拉 取 到 我 们 自己 的 仓库 中 的 一 个 新 的 分 支 上 。 第 二 种 方法 还 允许 我 们 将 通过 评审 的 工作 
合并 回 主 项 目 仓 库 。 你 应 该 选择 适用 于 你 的 情况 的 方法 。 如 果 你 还 不 确定 ， 选 择 第 二 种 方 
法 ， 并 在 你 的 本 地 仓库 中 添加 远程 仓库 的 引用 。 
在 这 两 种 方法 中 ， 我 们 需要 知道 远程 仓库 的 URL， 其 中 包含 你 想 要 评审 的 更 改 。 它 的 格式 
可 能 是 或 git@example.com:username/project.git。 一 旦 你 获得 了 远程 URL， 就 可 以 继续 了 。 
如 果 你 在 使 用 创建 一 份 新 的 克隆 的 第 一 种 方法 ， 请 离开 你 自己 的 项 目 仓库 副本 ， 也 许 会 到 
达 你 的 桌面 文件 来， 然后 使 用 下 面 的 命令 来 创建 一 份 你 想 要 评审 的 仓库 的 克隆 。 
$ git clone https://example.com/<username>/<project>.git 
回 到 你 刚 克 隆 的 新 仓库 ， 如 下 所 示 。 
$ cd project 
现在 ， 你 可 以 继续 阅读 8.5.3 1. 
如 果 你 在 使 用 第 二 种 方法 〈 在 你 自己 的 项 目 仓 库 副 本 中 添加 一 份 远 程 仓 库 ) ， 那 么 将 需要 
从 你 的 项 目 仓 库 中 开始 。 现 在 ， 在 命令 行 中 前 往 那 个 目录 。 


一 旦 来 到 你 的 项 目 目 录 ， 请 立即 为 包含 待 评审 分 支 的 派生 仓库 添加 一 个 新 的 远程 仓库 。 使 
用 你 正在 评审 的 工作 的 作者 的 用 户 名 ， 作 为 远程 的 名 称 。 例 如 ， 如 果 你 在 评审 Donna 的 工 
作 ， 而 她 的 仓库 位 于 https://example.com/donnal/likesgin， 命 令 将 会 如 下 所 示 。 


$ git add remote donna https://example.com/donna/ likesgin 
既然 你 已 经 有 了 一 个 新 的 远程 仓库 连接 ， 请 更 新 对 你 可 见 的 分 支 列表 ， 如 下 所 示 。 
$ get fetch donna 


现在 ， 你 可 以 继续 阅读 8.5.3 市。 


8.5.3 签 出 提议 分 支 
现在 ， 你 应 该 位 于 一 个 项 目 仓 库 中 ， 其 中 包含 了 你 需要 评审 的 分 支 。 下 一 步 是 签 出 你 需要 
的 分 支 的 一 份 副本 。 


列 出 仓库 中 的 所 有 分 支 ， 如 下 所 示 。 


$ git branch --all 





















































































































































此 命令 将 会 返回 一 个 分 支 列表 。 看 上 去 如 下 所 示 。 


* master 
remotes/origin/master 
remotes/origin/HEAD -> origin/master 
remotes/origin/61524-broken- link 


我 们 需要 评审 的 代码 位 于 这 个 列表 的 最 后 一 个 分 支 中 。 如 果 你 添加 了 一 个 额外 的 远程 来 下 
载 你 想 要 评审 的 分 支 ，origin 这 个 词 可 能 会 是 donna 之 类 的 。 在 下 面 的 指令 中 ， 用 你 分 配 
给 包含 评审 分 支 的 远程 的 别名 ， 替 换 origin 这 个 词 即 可 。 

$ git checkout --track origin/61524-broken- link 


现在 ， 我 们 在 本 地 分 支 中 拥有 了 一 份 自己 的 提议 更 改 的 副本 。 这 个 新 的 本 地 分 支 副 本 将 会 
被 命名 为 61524-broken-link。 通 过 添加 --track 参数 ， 我 们 在 切换 到 新 的 分 支 时 使 用 显 式 
的 连接 。 这 意味 着 如 果 我 们 需要 运行 push 命令 来 上 传 我 们 的 更 改 ，Git 将 会 知道 我 们 想 要 
将 我 们 的 更 改 上 传 到 哪 一 个 仓库 。 


现在 ， 我 们 可 以 开始 我 们 的 评审 。 


ST o sa 

8.6 评审 提议 的 更 改 

首先 ， 让 我 们 使 用 tog 命令 看 一 看 这 个 分 支 的 提交 历史 记录 ， 如 下 所 示 。 
$ git log master.. 


这 个 命令 给 我 们 提供 了 对 比分 支 中 所 有 不 同 提交 的 完整 日 志 说 明 (从 最 近 一 次 提交 开始 )。 
如 果 没 有 描述 性 的 提交 说 明 ， 则 将 工作 退回 开发 者 ， 要 求 她 添加 提交 说 明 。 第 8 章 介 绍 了 
如 何 编 写 良 好 的 提交 说 明 ， 第 6 章 介 绍 了 如 何 重 塑 历史 记录 (包括 使 用 交互 式 变 基 ， 在 之 
前 的 提交 后 添加 新 的 提交 说 明 )。 

为 了 获得 一 个 大 概 、 但 更 完整 的 历史 记录 ， 使 用 图 形 化 的 log 命令 来 验证 当前 的 分 支 。 通 
过 使 用 --graph 参数 ， 你 将 会 感受 到 这 个 分 支 是 如 何 融入 项 目 最 近 的 历史 记录 中 的 ， 如 下 
所 示 。 


$ git log --oneline --graph 


最 后 ， 使 用 diff 命令 。 这 个 命令 展示 了 你 的 仓库 中 的 两 个 节点 之 间 的 差异 。 这 些 节 点 可 
以 是 提交 对 象 、 分 支 顶 端 和 和 暂 存 区 。 我 们 想 要 比较 当前 的 工作 与 分 支 即 将 合并 “到 ”的 地 
方 ， 一 般 来 说 这 个 地 方 是 master 分 支 。 


$ git diff master 


当 你 运行 这 个 命令 来 输出 差异 时 ， 信 息 将 会 以 补丁 文件 的 形式 展示 。 补 丁 文件 难以 阅读 。 
你 看 到 的 行 都 以 + 和 - 开头 。 这 些 行 是 分 别 被 添加 或 移 除 的 行 。 你 可 以 使 用 上 下 键 来 深 动 
查看 这 些 更 改 。 当 你 审查 完 补 丁 之 后 ， 按 q 键 退 出 。 如 果 你 想 要 看 到 补丁 中 更 改 的 更 简略 
的 对 比 ， 那 么 可 以 考虑 只 列 出 文件 ， 然 后 每 次 查看 一 个 更 改 的 文件 ， 如 下 所 示 。 


$ git diff master --stat 
$ git diff master filename 


















































































































































让 我 们 看 一 看 一 个 补丁 文件 的 格式 ， 如 下 所 示 。 


diff --git a/jokes.txt b/jokes.txt 
index a3aa100..a660181 100644 
-- a/jokes.txt 
+++ ob/jokes.txt 
QQ -4,5 +4,5 QQ an investigator. 
The Past, The Present and The Future walked into a bar. 
It was tense. 


-What did one hat say to another's 

-You stay here, I'll go on a head! 

*What's the difference between a poorly dressed man on a tricycle and a 
well dressed man on a bicycle? 

*Attire. 


前 五 行 告诉 我 们 ， 我 们 正在 查看 两 个 文件 中 的 差异 ， 行 号 表示 文件 从 哪里 开始 出 现 不 同 。 
有 一 些 行 出 现在 更 改 前 ， 提 示 上 下 文 。 这 些 行 前 都 有 一 个 空格 的 缩 进 。 更 改 的 代码 行 随后 
以 前 级 - 〈 移 除 的 行 ) 或 + (添加 的 行 ) 标识 。 
你 还 可 以 通过 启动 Git 仓库 浏览 器 来 查看 我 们 目前 看 过 的 相同 信息 ， 以 获得 更 佳 的 可 视 化 
摘要 。 我 使 用 gitk， 通 过 brew 安装 的 Git 版 本 中 自 带 这 个 程序 (但 Apple 提供 的 版 本 没 
有 )。 任 何 仓 库 浏览 器 都 足够 使 用 了 ，Git 网 站 上 提供 了 很 多 可 视 化 的 客户 端 (https://git- 
scm.com/downloads/guis)， 如 下 所 示 。 

$ gitk 
当 你 运行 gitk 命令 上 时， 命令 行 中 将 会 启动 一 个 图 形 化 工具 。 单 击 每 个 提交 来 获得 更 详 
细 的 信息 。 很 多 工 单 系统 还 会 允许 你 并 排查 看 合并 提议 中 的 更 改 。 即 使 你 像 我 一 样 喜 
欢 命 令 行 ， 我 仍然 强烈 推荐 你 使 用 额外 的 图 形 化 工具 来 对 比 更 改 。 在 OS X 上 ， 我 喜欢 
Kaleidoscope 应 用 (http:/www.kaleidoscopeapp.com/) ， 因 为 它 还 允许 我 找 出 图 片 中 的 差异 ， 
而 不 只 是 代码 差异 。 


现在 ， 你 已 经 仔细 看 过 了 代码 ， 记 下 你 对 以 下 问题 的 答案 。 


。 代码 是 否 符合 项 目 确立 的 编码 规范 ? 

。 代码 是 否 控制 在 工 单 中 说 明 的 范围 内 ? 

。 代码 是 否 以 最 高 效 的 方式 ， 遵 循 行业 最 佳 实践 ? 

。 代码 是 否 根据 所 有 内 部 经 验 和 教训 ， 以 最 佳 的 方式 实现 ? 将 你 的 偏好 、 样 式 差 异 与 代码 
中 真正 的 问题 分 开 很 重要 。 


了 解 有 哪些 代码 更 改 之 后 ， 你 应 该 继续 将 这 些 更 改 应 用 到 你 的 本 地 环境 。 换 句 话说， 用 合 
适 的 方式 演 染 代码 。 假 设 这 是 一 个 网 站 ,现在 是 启动 你 的 浏览 器 并 查看 提议 的 更 改 的 时 候 
了 。 它 看 起 来 怎么 样 ?你 的 解决 方案 与 程序 员 的 设想 是 否 一 致 ”如 果 看 上 去 不 正确 ， 根 据 
你 正在 评审 的 更 改 类 型 ， 你 是 否 需要 清除 缓存 ， 或 许 需要 重新 构建 Sass 的 输出 来 更 新 项 目 
的 CSS? 

现在 ， 是 时 修 用 你 的 任何 测试 集 来 测试 代码 了 ， 比 如 以 下 测试 。 


。 代码 是 否 引 入 了 任何 回归 ? 
。 新 代码 的 性 能 是 否 比 得 上 旧 代 码 ? 下载 和 页 面 演 染 时 间 古 否 还 符合 你 的 项 目 性 能 预期 ? 
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。 所 有 单词 是 否 拼写 正确 ,以 及 是 否 遵循 任何 品牌 特定 的 指南 (例如 ,标题 和 句子 的 大 小 写 ) ? 


根据 这 个 特定 代码 更 改 的 原始 问题 的 性 质 ， 可 能 还 有 其 他 明显 的 问题 需要 作为 代码 评审 的 
一 部 分 指出 来 。 理 想 情 况 下 ， 你 的 团队 将 会 制定 自己 的 评审 事项 清单 。 


8.7 准备 你 的 反馈 
尽 你 所 能 创建 最 全 面 的 列表 ， 包 含 你 能 在 代码 中 找到 的 所 有 错误 和 正确 的 地 方 。 在 评审 过 
程 中 收 到 革 人 唆 唆 不 休 的 反馈 十 分 恼人 ， 因 此 我 们 会 尽 可 能 避免 “还 有 一 件 事 情 ” 这 种 情 
况 出 现 。 
假设 你 现在 有 一 大 堆 反 馈 。 虽 然 我 不 太 相 信 ， 但 也 可 能 你 没有 任何 反馈 。 发 布 你 的 内 部 评 
论 ， 使 用 便于 队友 使 用 的 方式 组 织 你 的 评论 。 对 于 到 目前 为 止 你 搜集 的 所 有 反馈 ， 可 以 将 
它们 分 成 以 下 几 类 。 
。 代码 错误 
它 无 法 编译 ，3| 入 了 回归 ,没有 通过 测试 集 ， 或 者 某 种 程度 上 明显 
对 需要 进行 修复 。 
。 代码 没有 遵守 最 佳 实 践 
你 有 你 自己 的 约定 ，Web 行业 有 自己 的 规范 。 这 些 修 补 是 十 分 重要 的 ， 但 开发 者 不 一 
定 能 意识 到 其 中 的 一 些 细节 。 


。 代码 的 写法 与 你 的 预期 不 符 
你 是 一 个 久 经 考验 的 开发 者 ， 但 在 开始 实践 之 前 ， 你 也 不 能 证 明 你 是 正确 的 。 


8.8 提交 你 的 评估 结果 


根据 这 个 新 的 分 类 ， 你 即将 参与 以 退 为 进 的 编码 。 如 果 问 题 只 是 一 个 拼写 错误 ， 并 且 属 于 
前 两 个 分 类 ， 那 么 将 它 修复 即 可 。 通 过 减少 在 开发 者 和 评审 者 之 间 代 码 需 要 来 回 传送 的 次 
数 ， 你 可 以 提高 团队 的 效率 。 显 而 易 见 的 拼写 错误 并 不 一 定 要 回 到 最 初 的 作者 那里 ， 不 是 
么 ?当然 ， 你 的 队友 可 能 会 有 一 些 槛 禾 ， 但 他 们 会 感谢 你 节省 了 他 们 的 时 间 。 希 望 下 次 他 
们 不 会 犯 这 样 的 错误 。 但 是 ， 如 果 这 是 第 四 次 或 者 第 五 次 了 ， 不 要 修复 这 个 问题 。 你 的 时 
间 同 样 是 宝贵 的 ， 你 的 队友 需要 在 给 你 评审 之 前 检查 他 们 自己 的 代码 。 

如 果 你 正在 纠结 的 更 改 属于 第 三 个 分 类 : 立即 停止 。 不 要 触 碰 代码 。 相 反 ， 在 这 个 问题 第 
一 次 被 发 现 的 地 方 更 新 这 个 工 单 ， 并 找 出 你 的 队友 为 什么 使 用 了 那 种 方法 。 询 问 “ 你 为 什 
么 要 在 这 里 使 用 这 个 国 数 ”或 许 会 引出 一 段 非常 有 趣 的 对 话 ， 这 段 对 话 中 有 关于 使 用 这 种 
方法 的 好 处 。 它 或 许 还 能 向 原作 者 展示 这 种 方法 的 缺点 。 通 过 开始 一 段 对 话 ， 评 审 可 以 提 
升 整个 团队 中 的 知识 水 平 。 通 过 开始 这 段 对 话 ， 你 还 可 能 会 发 现 ， 或 许 你 的 解决 问题 之 道 
不 是 唯一 可 行 的 方案 。 

如 有 果 你 “需要 ”对 代码 做 任何 修改 ， 这 些 修改 应 该 足够 小 而 无 足 轻重 。 你 不 应 该 在 同行 评 
审 环 节 作 出 任何 实质 性 的 修改 。 完 成 这 些微 小 的 编辑 ， 然 后 使 用 如 下 方法 ， 将 这 些 更 改 添 
加 到 你 的 本 地 仓库 。 
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$ git add --all 
$ git commit -m "Correcting «list problem» identified in peer review." 


你 可 以 简 述 你 的 更 改 ， 因 为 它 应 该 无 足 轻重 。 此 时 ， 你 应 该 将 评审 后 的 代码 推送 回 服务 
器 ， 供 原作 者 测试 和 评审 。 假 设 你 将 这 个 分 支 设 为 跟踪 分 支 ， 应 该 只 要 运行 以 下 这 个 命令 
即 可 。 

$ git push 
根据 你 的 评审 更 新 issue 队列 。 也 许 代码 需要 继续 修改 ， 也 许 它 写 得 足够 好 ， 现 在 是 时 候 
将 这 个 issue 队列 关闭 了 。 
重复 本 节 中 的 步骤 ， 直 到 提议 的 更 改 已 经 完成 ， 并 且 准 备 好 合并 到 主 分 支 中 。 


8.9 完成 评审 

到 目前 为 止 ， 我 们 一 直 在 比较 工 单 分 支 和 仓库 中 的 master 分 支 。 评 审 过 程 的 最 后 一 步 将 会 
是 把 工 单 分 支 合并 到 仓库 中 指定 的 主 分 支 (master) ， 并 清理 相应 的 工 单 分 支 。 

让 我 们 从 更 新 我 们 的 master 分 支 开 始 ， 确 保 我 们 可 以 在 合并 后 发 布 我 们 的 更 改 ， 如 下 所 示 。 


$ git checkout master 
$ git pull --rebase-preserve origin master 


深呼吸 ， 将 你 的 工 单 分 支 合并 回 你 项 目 仓库 中 的 主 分 支 。 正 如 其 名 ， 这 个 命令 将 会 在 你 的 
仓库 历史 记录 中 创建 一 个 新 的 提交 ， 用 于 在 必要 时 使 用 revert 命令 取消 合并 某 个 分 支 的 公 
共 副 本 ， 如 下 所 示 。 

$ git merge --no-ff 61524-broken-link 
这 个 合并 要 么 成 功 ， 要 么 失败 。 如 果 合 并 失败 了 ， 代 码 的 原作 者 通常 能 够 更 好 地 措 清 如 何 
修复 合并 错误 ， 你 可 能 需要 请 求 他 们 来 帮 你 解决 这 些 冲 突 。 第 6 章 中 介绍 了 处 理 合 并 错误 
的 建议 。 



























































你 的 团队 在 使 用 哪 种 分 支 策略 ? 

使 用 流水 线 型 的 主线 分 支 策 略 的 团队 应 该 确保 他 们 使 用 rebase 命令 同步 他 
们 的 工作 分 支 61524-bproken-Link 和 目标 分 支 master, E% H HERD XJA, 
新 的 工作 应 该 使 用 --ff-only 而 不 是 --no-ff 来 合并 。 它 将 忽略 合并 提交 ， 
移 除 工 单 分 支 的 踪迹 ， 并 留 下 清晰 的 图 形 化 历史 记录 。 看 看 你 的 软件 正在 使 
用 哪 种 分 支 策 略 ， 并 由 此 决定 你 应 该 使 用 那 种 方法 来 合并 你 的 工作 。 
































一 旦 分 支 合 并 后 ， 你 就 可 以 将 master 分 支 上 传 至 中 心 仓 库 ， 以 共享 修订 后 的 master 分 支 ， 
如 下 所 示 。 


$ git push 


一 旦 新 的 提交 顺利 地 整合 到 master 分 支 后 ， 你 就 可 以 删除 本 地 仓库 和 中 心 仓 库 中 旧 的 工 单 
分 支 的 副本 。 此 时 只 剩 下 以 下 这 些 基本 清理 工作 。 
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$ git branch --delete 61524-broken-link 
$ git push origin --delete 61524-broken-link 


8.10 小结 

同行 评审 环节 可 以 帮助 你 的 团队 。 我 发 现 它 在 让 想法 变 成 代码 之 前 促进 了 交流 。 作 为 一 个 
额外 的 好 处 ， 它 通常 鼓励 开发 者 开始 寻找 自动 化 测试 流程 的 方法 ， 以 提高 评审 效率 。 是 
的 ， 它 会 花费 更 多 时 间 ， 但 如 果 你 能 看 到 它 带 来 的 好 处 ， 我 相信 这 些 时 间 是 值得 的 。 






























































第 9 章 


寻找 并 修复 hug 





即使 有 最 好 的 评审 环节 ， 有 时 也 会 将 bug 引入 生产 环境 。 或 许 这 个 bug 是 由 于 合并 失误 或 
者 测试 没有 和 覆盖 的 场景 引入 的 。 不 管 问题 的 根源 是 什么 ，Git 将 会 帮助 你 找 出 在 何 时 由 谁 
引入 了 这 段 讨 厌 的 代码 。 这 将 使 你 理解 出 现在 你 的 系统 中 的 这 段 代 码 的 上 下 文 ， 并 在 也 许 
你 不 熟悉 的 那 块 代码 库 中 ， 告 诉 你 能 帮 你 解决 问题 的 最 佳人 选 。 

主要 有 两 种 方法 可 以 应 用 你 的 调查 技巧 : 使 用 现 有 代码 来 定位 问题 ， 和 使 用 代码 历史 记 
录 来 定位 问题 。 当 你 同时 使 用 这 两 种 技巧 时 ， 将 会 是 最 高 效 的 。 例 如 ， 在 我 调试 代码 的 
时 候 ， 几 乎 总 是 从 阅读 代码 开始 。 这 是 我 从 做 过 的 各 种 Web 前 端 开发 中 学 到 的 ， 如 使 用 
Firebug 来 调试 一 个 网 页 ， 找 到 有 问题 的 CSS。 它 绝对 不 是 调试 代码 的 唯一 方式 ， 而 且 对 于 
很 多 项 目 来 说 ， 这 都 不 是 一 个 可 行 的 策略 。 

在 本 章 中 ， 你 将 会 学 到 以 下 内 容 。 

。 使 用 stash 保存 当前 工作 的 进度 ， 以 签 出 到 另 一 个 分 支 

。 使 用 blame 寻找 文件 的 历史 版 本 

。 使 用 bisect 寻找 最 近 一 个 正确 的 提交 

在 本 章 结束 前 ， 你 还 将 更 好 地 理解 你 现在 在 Git 中 储存 历史 记录 的 方式 将 会 影响 到 你 以 后 
从 错误 中 恢复 的 方式 。 你 将 会 意识 到 一 个 良好 的 提交 说 明 是 多 么 重要 ， 同 时 看 到 变 基 工 作 
流 如 何 帮助 你 创建 更 容易 被 bisect 理解 的 历史 记录 。 本 章 不 会 包括 如 何 撤销 找到 的 错误 的 
说 明 ， 因 为 这 些 内 容 在 第 6 章 中 已 经 提 到 。 

喜欢 通过 视频 教程 学 习 的 读者 可 以 参考 本 书 附 带 的 系列 视频 ，Collaborating with Git (http:// 
shop.oreilly.com/product/0636920034872.do) 。 
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9.1 使 用 stash 进 行 紧急 的 bug 修 复 


在 第 6 章 中 ， 你 学 到 了 如 何 调整 你 的 提交 说 明 ， 但 为 了 防止 意外 ， 事 实 上 暂时 搓 置 你 的 工 
作 可 能 会 更 合适 。 这 可 以 通过 stash (保存 进度 ) 命令 完成 。 这 个 命令 允许 你 临时 搁置 你 
进行 了 一 半 、 以 后 某 个 时 候 想 要 继续 的 工作 。 

现实 世界 中 Git 的 应 用 

我 最 喜欢 的 一 个 Git 相关 的 笑话 是 我 的 朋友 Jeff Eaton 在 DrupalCon Prague 说 

的 。 他 十 分 应 景 地 作出 了 这 个 评论 :“ 像 git stash 那样 可 以 暂时 不 用 考虑 是 否 
合乎 道德 。” 我 希望 我 还 记得 当时 的 情景 (是 恐怖 电影 ?还 是 在 啤酒 吧 ) ,但 

这 个 小 笑话 确实 打动 了 我 。 




















从 代码 的 角度 来 看 ，stash 允许 你 避免 需要 以 后 重 做 的 无 用 提交 。 这 些 无 用 的 提交 通常 在 你 
解决 一 个 问题 ， 但 需要 临时 切换 到 一 个 不 同 的 分 支 时 出 现 ， 而 你 只 有 在 工作 目录 干净 时 才 
可 以 切换 分 支 。 与 分 支 或 单个 提交 不 同 ，stash 不 能 被 共享 ， 它 只 存在 于 你 的 本 地 仓库 中 。 


为 了 新 建 一 个 包含 你 当前 工作 目录 中 更 改 的 stash， 你 需要 使 用 stash 命令 。 如 果 你 喜欢 明 
确 ， 可 以 加 上 save 参数 。 不 过 ， 这 个 参数 是 默认 的 ， 如 果 你 想 少 襄 儿 个 键 ， 就 不 需要 加 上 
了 ， 如 下 所 示 。 


$ git stash save 



































Saved working directory and index state WIP on master: \ 

d7fe997 [9387] Adding test: check user exists 

HEAD is now at d7fe997 [9387] Adding test: check user exists 
你 将 会 注意 到 这 个 命令 只 会 保存 Git 已 知 的 文件 的 进度 。 如 果 你 有 尚未 提交 过 的 新 文件 ， 
这 些 文件 将 不 会 被 加 入 stash， 而 其 他 更 改 会 进入 一 个 stash， 使 你 无 法 在 清理 完 所 有 未 跟 
踪 的 更 改 前 切换 到 一 个 不 同 的 分 支 。 为 了 加 入 未 跟踪 文件 ， 请 添加 --include-untracked 
参数 ， 如 下 所 示 。 


$ git stash save --include-untracked 


或 者 ， 如 果 你 想 要 丢弃 这 些 文件 ， 而 不 是 将 它们 放 到 你 的 stash 中 ， 可 以 运行 以 下 命令 。 


$ git stash save 
$ git clean -d 


每 次 你 在 不 干净 的 工作 目录 中 使 用 stash 命令 时 ， 一 个 新 的 stash 将 会 创建 。 通 过 添加 
list 参数 ， 你 可 以 看 到 一 列 你 保存 的 stash， 如 下 所 示 。 


$ git stash list 








stash@{0}: WIP on master: d7fe997 [9387] Adding test: check user exists 


如 有 果 你 只 是 想 花 几 分 钟 回顾 一 个 stash， 这 没什么 问题 。 你 短期 的 记忆 完全 能 够 记 住 几 分 钟 























注 1: 就 像 看 恐怖 电影 时 ， 我 们 或 许 会 觉得 有 人 被 杀 死 很 有 趣 ， 但 这 仅 限 于 看 电影 的 时 候 。 一 一 译 者 注 
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前 发 生 的 事情 ， 但 如 果 你 想 要 记 住 更 长 时 间 ， 并 且 有 更 多 需要 记 住 的 回忆 ， 你 会 很 难 想起 
每 个 stash 中 有 什么 。 
使 用 show 命令 来 查看 一 个 stash 中 的 内 容 。 选 中 的 stash 补丁 中 的 元 信息 和 工作 目录 中 保存 
进度 的 更 改 将 会 展现 ， 如 下 所 示 。 

$ git show stash@{0} 
如 果 你 认为 你 无 法 通过 查看 代码 想起 做 过 的 事 ， 那 么 可 以 编写 一 段 精简 的 描述 替代 提交 说 
明 ， 包 括 你 在 保存 工作 目录 的 进度 时 正在 进行 的 工作 。 











添加 一 段 描述 
如 果 你 想 要 添加 一 段 描 述 ， 那 么 将 需要 显 式 添加 save 参数 。 


Git 允许 你 储存 多 步 stash， 因 此 如 果 你 正在 解决 一 个 庞大 的 问题 ， 这 将 会 尤其 有 用 ， 最 终 
会 在 同一 个 分 支 中 创建 多 步 stash， 如 下 所 示 。 


$ git stash save --include-untracked "terse description of the stashed work" 


现在 ， 如 果 你 再 次 检查 stash 列表 ， 将 会 看 到 你 之 前 的 stash 和 新 的 stash， 如 下 所 示 。 


$ git stash list 
































stash@{0}: On master: terse description of the stashed work 

stash@{1}: WIP on master: d79e997 Revert "Merge branch 'video-lessons' ... 
最 新 的 stash 将 会 出 现在 列表 顶端 。 注 意 stash 的 引用 编号 在 你 创建 更 多 stash 时 是 如 何 变 
化 的 ， 这 个 赋值 是 可 变 的 ， 而 不 是 一 个 持久 的 引用 编号 。 如 果 你 在 同一 个 分 支 中 创建 了 多 
个 提交 ， 这 会 有 些 令 人 困惑 ， 但 如 果 你 给 每 个 stash 一 个 精简 的 描述 ， 那 么 在 继续 工作 时 
就 更 容易 想起 你 想 要 应 用 的 stash， 以 及 哪些 stash 已 经 过 时 而 需要 被 删除 。 


保存 进度 的 工作 可 以 应 用 于 任何 分 支 
如 果 你 意识 到 你 在 错误 的 分 文 上 工作 但 还 没有 提交 ， 那 么 也 可 以 使 用 这 个 命 
令 。 你 可 以 保存 你 的 工作 进度 ， 切 换 分 支 ， 然 后 重新 应 用 stash 中 的 工作 。 











一 旦 你 准备 好 继续 工作 ， 就 需要 确定 你 想 要 使 用 哪个 stash， 然 后 应 用 它 ， 如 下 所 示 。 


$ git stash list 
$ git stash apply stash@{0} 


如 果 你 使 用 apply 命令 ， 这 个 stash 将 会 持久 化 。 如 有 果 你 的 stash 开始 堆积 ， 这 会 有 些 困惑 。 
要 想 移 除 某 个 stash， 可 以 使 用 drop 命令 来 删除 它 ， 如 下 所 示 。 


$ git stash drop stash@{0} 


如 有 果 你 知道 自己 就 是 喜欢 屯 东 西 ， 并 且 认 为 自己 不 擅长 清理 旧 的 stash， 那 么 应 该 使 用 单个 














A 
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pop 命令 来 apply (应 用 ) 和 drop (X38) 这 个 stash。 假 设 你 只 有 一 个 stasn， 那 么 命令 将 
如 下 所 示 。 


$ git stash pop 
你 还 可 以 使 用 与 apply 和 drop 相同 的 结构 来 pop (弹出 ) 特定 的 stash， 如 下 所 示 。 


$ git stash pop stash@{0} 


有 疑问 时 ，Git 假设 你 想 要 最 新 的 一 个 stash 
如 果 你 只 保存 了 一 个 stash， 则 不 需要 列 出 所 有 你 想 要 的 stash。 如 果 你 省 略 
stash 的 名 称 ， 而 stash 不 止 一 个 ， 那 么 Git 将 会 使 用 最 新 的 一 个 stash (列表 
中 最 顶部 的 那个 ， 它 将 被 命名 为 stash@{0})。 





现在 ， 你 应 该 能 够 使 用 stash 命令 来 临时 搁置 你 的 工作 。 尽 管 你 随时 都 可 以 保存 你 的 工作 
进度 ， 但 应 该 在 真 的 被 打 断 了 的 时 候 才 使 用 这 个 命令 。 如 果 你 完成 了 一 份 完整 的 工作 ， 请 
使 用 commit 命令 。 如 果 你 决定 以 后 添加 更 多 工作 ， 那 么 永远 可 以 选择 rebase 你 的 分 支 ， 
合并 你 之 前 做 出 的 提交 。 


9.2 比较 历史 记录 的 研究 


将 出 错 的 代码 和 另 一 份 代码 相 比较 ， 是 用 于 查找 代码 为 什么 无 法 工作 最 基本 的 方法 之 一 。 
尔 可 以 使 用 相对 历史 记录 来 轻松 地 做 到 这 一 点 。 与 阅读 某 个 特定 分 支 的 日 志 相 比 ， 你 可 以 
将 一 个 分 支 与 男 一 个 分 支 ， 或 男 一 个 时 间 点 相 比 较 。 


大 多 数 命令 以 前 已 经 出 现 过 ， 但 这 次 ， 带 着 具体 的 问题 来 看 它们 。 考 虑 图 9-1 中 的 提交 历 
史记 录 图 。 有 两 个 分 支 拥有 共同 的 历史 记录 : 其 中 一 个 包含 一 个 已 知 的 bag， 而 另 一 个 确 
信和 是 正确 的 。 与 包含 正确 代码 的 分 支 相 比 ， 包 含 错误 代码 的 分 支 有 四 个 不 同 的 提交 。 正 确 
的 分 支 只 有 两 个 新 的 提交 ， 不 包括 在 错误 的 分 支 中 。 

















正确 的 分 支 








出 错 的 分 支 








父 分 支 或 祖先 分 支 
图 9-1: 具有 共同 祖先 的 两 个 分 支 分 叉 出 不 同 数量 的 分 支 
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需要 一 个 样 例 仓库 来 练习 ? 

如 果 你 想 要 尝试 接 下 来 的 练习 ， 请 从 “Git 团队 协作 ”网 站 (http:/ 
gitforteams.com/) 下 载 一 份 仓库 的 副本 。 这 个 仓库 设置 了 必要 的 分 支 ， 这样 
你 就 不 需要 自己 复制 这 个 场景 。 




















使 用 log 命令 ,你 可 以 隔离 历史 记录 的 多 个 碎片 。 在 笔记 本 上 画 一 张 图 ， 在 每 个 命令 表示 
的 提交 上 画 一 个 圆圈 。 你 也 可 以 试 着 使 用 diff 取代 这 些 命令 中 的 log， 来 获得 不 同 的 输出 。 
在 当前 分 支 上 ， 我 使 用 下 面 这 个 命令 来 查看 除了 最 近 一 次 提交 之 外 的 所 有 工作 。 

$ git log HEAD^ 
在 当前 分 支 上 ， 我 使 用 下 面 这 个 命令 来 查看 除了 最 近 三 次 提交 之 外 的 所 有 工作 。 

$ git log HEAD-3 
你 可 以 站 在 不 同 的 参考 点 比较 这 些 提 交 。 你 站 在 一 收 高 楼 的 窗 边 ， 俯 视 楼 下 的 街道 。 你 上 
以 看 到 其 他 矮小 一 些 的 建筑 的 屋顶 。 现 在 ， 想 象 你 站 在 街 上 仰视 这 幢 高 楼 。 你 可 以 看 到 人 
们 坐 在 咖啡 馆 的 遮阳 伞 下 。 在 Git 的 上 下 文中 ， 这 意味 着 你 可 以 使 用 任意 分 支 来 作为 参考 
点 ， 如 下 所 示 。 


$ git log since last merge to..what's been added here --oneline 
例如 ， 我 使 用 以 下 这 个 命令 来 查看 包含 在 正确 分 支 中 而 非 错误 分 支 中 的 提交 。 
$ git log working..broken 
相反 呢 ? 如 何 查看 包含 在 错误 分 支 中 而 不 是 正确 分 支 中 的 提交 ? 可 以 像 下 面 这 样 做 。 
$ git log working..broken 
如 果 我 想 查 看 包含 在 错误 分 支 中 而 非 正确 分 支 中 的 代码 ， 我 会 像 下 面 这 样 做 。 
$ git difftool working..broken 
你 也 可 以 比较 远程 分 支 。 不 要 忘记 在 比较 前 使 用 fetch 下 载 最 新 的 版 本 ， 如 下 所 示 。 


$ git fetch 
$ git log working..remote nickname/broken 


如 果 你 无 法 获得 足够 的 信息 ， 那 么 可 以 使 用 带 -s 参数 的 log 来 查找 提交 说 明 ， 或 提交 的 更 
改 中 被 应 用 (或 移 除 ) 的 特定 文本 字符 串 。 如 果 你 在 提交 说 明 中 使 用 了 固定 的 词汇 ， 使 用 
这 种 方式 查找 你 的 仓库 会 明显 更 有 帮助 。 例 如 ， 我 总 是 试 着 在 提交 说 明 中 加 入 文件 名 ， 或 
等 价 的 缩写 ， 以 便 日 后 进行 第 选 ( 当 这 个 文件 被 添加 到 本 书 的 仓库 中 去 时 ， 它 会 得 到 一 个 
包含 CH09 的 提交 说 明 )， 如 下 所 示 。 

$ git log -S foo 
如 果 -S 参数 让 你 感到 惊喜 ， 那 么 好 消息 来 了 ! 你 还 可 以 使 用 -6 参数 来 根据 正则 表达 式 查 找 。 


使 用 这 些 命令 可 以 帮助 你 隔离 造成 问题 的 文件 。 一 旦 你 找到 了 文件 名 ， 就 可 以 更 仔细 地 调 
查 这 些 文件 。 
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9.3 使 用 blLame 调 碍 文件 历史 版 本 





t 








们 使 用 log 命令 





如 何 拼 到 一 起 变 成 你 正在 查看 的 文件 的 。 


blame 命令 允许 你 逐 
(图 9-2), 





尤其 是 当 提交 说 明 没有 给 
来 查看 仓库 演进 的 历史 。 但 它 无 法 


给 出 一 





行 查看 一 份 文件 ， 显 示 每 行 的 最 近 更改 时 间 、 作 者 和 包 








在 团队 中 协作 时 ， 查 看 谁 之 前 修改 过 一 份 文件 将 会 十 分 有 用 。 文 件 的 修改 者 是 有 资格 讲解 
历史 更 改 为 什么 做 出 的 最 好 人 选 ， 更 多 线索 时 。 一 般 来 说 ,我 


个 很 好 的 摘要 ， 关 于 这 些 更 改 是 


含 更 改 的 提交 





3e524e0b 4 
3e524e0b 5 
3e524e0b 6 
8baf4735 7 
7f2550a8 8 
8baf4735 9 





8baf4735 





该 行文 本 
[ 内 容 介绍 ] 


本 节 介 绍 了 Git 中 的 命令 





需要 上 手 实践 的 活动 在 本 章 随处 可 见 …… 








4che6> 让 你 能 够 浏览 历史 








同一 个 提交 中 修改 的 行 













9-2: blame 人 允许 你 通 


过 提交 ID 和 作者 ， 列 出 每 








为 了 检验 README.md 文件 

例 9-1 blame 命令 的 输出 
$ git blame README.md 
3e9dd558 (emmajane 2014-04-23 
^00de359 (Emma Jane 2014-04-23 
^00de359 (Emma Jane 2014-04-23 
3e9dd558 (emmajane 2014-04-23 
7874193c (emmajane 2014-06-26 
3e9dd558 (emmajane 2014-04-23 
3e9dd558 (emmajane 2014-04-23 
00000000 (Not Committed Yet 2015-01-15 
00000000 (Not Committed Yet 2015-01-15 
3e9dd558 (emmajane 2014-04-23 
3e9dd558 (emmajane 2014-04-23 
5cc35764 (emmajane 2014-06-25 
3e9dd558 (emmajane 2014-04-23 


从 左 到 右 ， 


。 提交 的 散 列 ID 
。 作者 名 


这 些 列 显示 了 以 下 各 项 。 


行 加 入 文件 的 时 间 


22: 
18: 
18: 
22: 
00: 
22; 
22: 
21: 
21: 
22: 
22: 
17: 
22: 


TI 
54: 
54: 
11: 
37: 
11: 
11; 
08: 
08: 
11: 
Ti: 
45: 
TL 


40 
03 
03 
40 
41 
40 
40 
09 
09 
40 
40 
38 
40 


-0400 
-0700 
-0700 
-0400 
-0400 
-0400 
-0400 
+0000 
+0000 
-0400 
-0400 
-0400 
-0400 


， 请 使 用 例 9-1 中 显示 的 blame 命令 ， 如 下 所 示 。 


1) Git for Teams of One... 


2) 
3) 


4) Supporting files for ... 


5) developer work flow for ... 
6) version control system, git 


7) 
8) Test edit! 
9) 


10) ## Contents 
11) 

12) */slides* 
13) 
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。 日 期 

。 68 

。 这 个 文件 中 特定 行 的 内 容 

在 例 9-1 中 ， 你 或 许 已 经 注意 到 其 中 列 出 了 三 个 作者 : Not Committed Yet, emmajane 和 
Emma Jane。 和 希望 第 一 个 名 称 能 够 解释 自己 : 这 些 更 改 位 于 我 的 工作 目录 ， 但 尚未 被 提交 。 
我 两 个 版 本 的 名 称 是 由 于 我 的 Git 设置 变动 造成 了 不 一 致 。 你 可 以 在 附录 C 中 读 到 更 多 如 
何 自 定义 称呼 的 内 容 。 

其 中 两 行 以 ^ 开头 。 这 两 行 自从 第 一 次 提交 后 没有 再 被 修改 过 。 

小 心 ! “blame”( 责 备 ) 这 个 词 可 能 会 诱导 你 产生 负面 的 想法 

blame 命令 的 命名 很 糟糕 。 它 瞬间 就 不 必要 地 制造 了 对 代码 的 负面 看 法 。 我 

更 喜欢 用 于 Git 的 竞争 对 手 Bazaar 的 命令 annotate (批注 )， 以 及 它 的 别名 
priase (称赞 ) (完整 地 说 ，Bazaar 对 于 annotate 还 有 一 个 别名 blame), Git 
没有 annotate 命令 ， 但 这 个 命令 的 文档 说 明 只 是 出 于 兼容 性 考虑 。 它 不 是 一 

个 真正 的 别名 ， 而 blame 和 annotate 的 别名 有 些许 差别 。 

最 后 一 个 修改 某 行 代码 的 人 通常 最 有 资格 解释 他 们 的 目的 ， 提 前 去 找 他 们 的 
麻烦 会 减少 以 后 他 们 向 你 寻求 帮助 的 可 能 性 ， 同 时 可 以 避免 增加 你 需要 解决 
他 们 未 来 错误 的 可 能 性 。 检 查 你 在 使 用 这 个 命令 时 的 态度 ， 看 看 你 能 不 能 从 

归咎 的 思维 方式 转换 成 简单 的 批注 。 





nz 






























































一 旦 你 定位 到 了 文件 中 看 上 去 有 点 意思 的 一 行 ， 可 以 使 用 提交 ID 以 及 log, diff 和 show 
命令 来 继续 深究 。 表 9-1 列 出 了 每 个 命令 能 帮 你 隔离 什么 。 
表 9-1: 使 用 Log、diff 和 show 的 原因 
描述 命令 
显示 某 个 特定 提交 的 元 数据 log commit 
显示 某 个 特定 提交 中 更 改 的 代码 show commit 
显示 某 个 特定 提交 后 更 改 的 代码 ”diff comit 
从 使 用 log 命令 查看 提交 说 明 开 始 ， 如 下 所 示 。 

$ git show «commit» 
如 果 提 交 说 明 编 写 得 很 好 ， 那 么 其 中 应 该 包含 关于 这 个 特定 提交 中 为 什么 做 出 了 这 些 更 改 
的 说 明 。 如 果 详 细 的 提交 说 明 中 包含 一 个 指向 项 目 管理 系统 中 工 单 号 的 引用 ， 你 其 至 可 以 
阅读 这 个 更 改 的 讨论 ， 让 你 深 入 了 解 开发 者 在 创建 这 个 修复 时 是 怎么 想 的 。 在 跟踪 系统 
中 ， 你 还 可 以 看 到 其 他 参与 的 开发 者 ， 以 及 这 个 特定 更 改 的 评审 团队 的 所 有 成 员 。 
要 想 看 到 相同 数量 、 但 在 某 个 节点 之 后 所 有 提交 的 详细 信息 ， 可 以 使 用 以 下 命令 。 


$ git log --patch «commit» 


在 这 个 上 下 文中 ，- patch 参数 向 你 展示 每 个 提交 之 间 的 更 改 (而 diff 命令 是 向 你 展示 引 












































用 提交 和 工作 目录 中 的 文件 之 间 差 异 的 )。 


blame 只 能 告诉 你 可 见 的 内 容 

blame 不 是 万 能 的 。 如 果 bug 并 非 是 由 你 正在 查看 的 版 本 的 文件 中 的 某 行 引 
AW, blane 将 不 会 告诉 你 谁 最 近 编 辑 了 这 份 文件 。 因 此 ， 这 是 一 个 好 用 的 
工具 ， 但 不 是 魔法 。 

















组 合 使 用 blame、log 和 diff 命令 ， 你 现在 应 该 可 以 在 单个 文件 的 完整 历史 记录 中 和 同时 
发 生 的 其 他 更 改 的 上 下 文中 评审 这 个 文件 的 历史 记录 。 使 用 提交 说 明 ， 你 或 许 还 能 够 追踪 
更 改 发 生 的 原因 。 通 过 一 些 细致 的 调查 ， 你 可 以 在 询问 代码 作者 时 展开 一 段 富 有 成 效 的 对 
话 ， 而 不 是 一 段 神探 可 伦 坡 风格 的 审问 。 


9.4 ”使 用 bisect 重 演 历 史 


如 果 你 不 知道 问题 在 哪个 文件 中 ， 通 常 很 难 找到 bug 是 什么 时 候 进入 你 的 代码 中 的 。 如 有 果 
你 正在 查看 的 错误 消息 被 输出 到 屏幕 上 ， 相 对 来 说 查找 代码 库 中 的 文件 来 定位 正确 的 文件 
就 更 容易 了 。 在 错误 发 生 时 ， 有 了 时 错误 消息 会 包含 文件 名 和 行 号 。 在 任何 情况 下 ， 你 都 可 
以 使 用 diff, log FH blame 命令 来 得 到 对 错误 来 源 的 更 好 理解 。 有 时 有 问题 的 代码 并 没有 
在 错误 消息 中 留 下 足够 的 线索 来 使 用 这 些 工 具 。 现 在 ,该 bisect 来 大 显 身 手 了 ! 


bisect 对 以 往 的 提交 执行 二 分 查找 ， 来 帮助 你 找到 代码 从 一 个 已 知 正 确 的 状态 到 一 个 已 知 
错误 的 状态 之 间 的 提交 。 与 平时 的 签 出 提交 不 同 ，bisect 继续 游荡 于 你 的 历史 记录 中 (以 
一 种 非常 合理 的 方式 )， 直 到 你 有 了 足够 的 线索 来 辨认 是 哪个 提交 引入 了 错误 的 代码 。 这 
有 点 像 重 演 开发 者 在 代码 库 中 的 工作 历史 。 在 bisect (二 分 查找 ) 过 程 的 每 个 节点 上 ， 你 
可 以 启动 这 个 产品 (编译 代码 ， 在 浏览 器 中 打开 ， 在 你 的 手机 上 安装 这 个 应 用 ， 进 行 任何 
对 代码 库 来 说 合适 的 事 ) 并 确定 历史 上 此 时 的 代码 是 正确 的 还 是 错误 的 。 一 旦 你 找到 出 错 
的 时 间 点 ， 就 可 以 在 那个 时 间 点 上 修复 历史 记录 。 就 像 电影 《 回 到 未 来 》 中 那样 ，Git 就 


是 你 的 DeLorean。 


要 想 开始 ， 你 需要 来 到 仓库 最 外 层 的 目录 。 隐 藏 的 git 文件 夹 就 位 于 这 个 文件 夹 中 。 开 始 
bisect 过 程 ， 并 告诉 Git 一 个 代码 正确 的 提交 ID 和 一 个 代码 错误 的 提交 ID (l 9-2), 


例 9-2 标记 正确 和 错误 的 提交 以 进行 二 分 查找 
$ git bisect start 
$ git bisect good <commit-id> 
$ git bisect bad «commit-id 


Big, Git 将 会 继续 每 次 签 出 一 系列 提交 ， 寻 找 代 码 从 错误 变 回 正确 的 那个 提交 ， 如 下 所 示 。 


$ git bisect start 
$ git bisect bad c04f374 
$ git bisect good 93b64fc 











































































































Bisecting: 10 revisions left to test after this (roughly 4 steps) 
[0075f7eda67326f1746] Merge branch 'video-lessons' into integration test 
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仓库 现在 处 于 分 离 式 HEAD 状态 。 此 时 ， 你 需要 确认 这 段 代 码 是 正确 的 还 是 错误 的 ， 并 报告 
你 的 发 现 ， 如 下 所 示 。 


$ git bisect bad 





Bisecting: 5 revisions left to test after this (roughly 3 steps) 
[ed8056eb4b2aaf00e6d] Lesson 4: Adding details on using git config 


$ git bisect bad 


Bisecting: 2 revisions left to test after this (roughly 1 step) 
[c88a02babc42bb00a383] Lesson 4: Adding new lesson on configuring Git 


$ git bisect good 


Bisecting: 0 revisions left to test after this (roughly 1 step) 
[f1fa8e7e382f68c0558] Lesson 3: Extended descriptions for cloning a ... 


$ git bisect good 


ed8056eb4b2aaf00e6d is the first bad commit 
commit ed8056eb4b2aaf00e6d9d183f974ed612d6f10e6 
Author: emmajane «emma(emmajane.net» 

Date: Sun Sep 7 12:50:58 2014 +0100 


Lesson 4: Adding details on using git config 
Added commands to customize the following: 


- username (or real name, as you prefer) 
- email address 
- enable color helpers within the git messages 


Added a self-study piece on customizing your command prompt to include 
additional color and branch information. 


:040000 040000 e927a1263e6e23eb5237a363a20640f62349b27d 
31bc6c57d6acd8de214a63a47914b324d6809a866 M lessons 


有 问题 的 提交 已 经 找到 了 。 此 时 ， 你 处 在 分 离 式 HEAD 状态 ， 但 也 知道 了 你 需要 回 到 哪个 
提交 。 要 带 着 白 的 信息 回 到 你 的 分 支 顺 端 ， 请 使 用 子 命令 rset。 这 个 命令 还 可 以 在 bisect 
过 程 的 任何 节点 上 用 于 中 止 查找 并 回 到 分 支 上 最 近 一 个 提交 ， 如 下 所 示 。 


$ git bisect reset 
如 果 你 还 没有 经 历 过 大 量 编 程 ， 二 分 查找 过 程 可 能 会 像 是 魔法 。( 是 真 的 非常 酷 炫 的 魔法 
ee De te 
A (图 9-3)。 两 侧 正确 和 错误 的 提交 将 会 在 你 刚 配 置 过 的 gitk 的 图 形 界面 中 进行 标记 。 




































































e^o gitk: start-from-remote-clone 












[Bisect/Bad] Revert "Revert "Adding office hours reminder." emmajane «emmagemmajane. 2015-01-09 22:00:16 
Reversing the merge commit a1173fd. emmajane cemmagemmajane. 2015-01-09 21:59:36 
Revert "unmerging third change" emmajane cemmagemmajane. 2015-01-08 16:36:20 
Merge branch 'unmerging' emmajane <emma@emmajane 2015-01-08 16:26:15 
[] unmerging third change emmajane cemmagemmajane.! | 2015-01-08 13:44:41 

unmerging second change emmajane cemmaQemmajane. 2015-01-08 13:44:24 
unmerging first change. emmajane «emmagemmajane.! 2015-01-08 13:44:05 
Revert "Adding office hours reminder." emmajane cemmagemmajane. 2015-01-06 17:18:47 
[remotes]upstream Correcting joke about horses and baths. emmajane cemmagemmajane. 2014-09-10 16:53:50 
emmajane cemmagemmajane. 2014-09-10 13:00:40 

a SADa] Adding an Easter egg of bad jokes. emmajane <emma@emmajane.t 2014-09-10 11:12:01 

pe e i emmajane <emmaĝemmajane.! 2014-09-10 19:43:08 

Lesson 7: Added intro on branching; reformatted the lessons emmajane <emmaĝemmajane.t 2014-09-09 04:05:19 

Lesson 9: Removing lesson stubs from subsequent lessons. emmajane <emma@emmajane.t 2014-09-08 14:57:08 
Lesson 6: Extended descriptions for adding remotes emmajane cemmagemmajane. 2014-09-08 11:59:56 
Lesson 5: Extending notes for starting a local repository emmajane <emma@emmajane.t 2014-09-07 20:43:38 
Lesson 4: Adding details on using git config emmajane cemmagemmajane. 2014-09-07 12:50:58 
Lesson 3: Extended descriptions for cloning a repository, and using git log emmajane <emma@emmajane.t 2014-09-07 12:16:16 
Renumbering lessons after addding Lesson 4 on configuration emmajane cemmagemmajane. 2014-09-07 12:05:44 
Lesson 4: Adding new lesson on configuring Git emmajane «emmagemmajane. 2014-09-07 12:03:41 
Adi sh profile for coloured pror emmajane «emmagemmajane. | 2014-09-07 11:21:12 
50jeag b] Adding sample git config file. emmajane cemmagemmajane. 2014-09-07 11:17:47 

emmajane cemmagemmajane. 2014-09-09 21:21:19 

Adding office hours reminder. emmajane cemmagemmajane. 2014-07-22 16:36:54 





G07517edo673261174623ecaSecüOfdS4d?f4b?4 € > Row 12 / 24 
Find 4L 个 commit containing: v Exact ~ Allfields ~ 


Search » Patch — Tree 
Comments 


* Diff ^ Old version New version Lines of context: 3 | e Ignore space change Line diff ~ 


Author: emmajane «emmaBemmajane.net? 2014-89-10 19:43:08 
Committer: emmajane XemmaBemmajane.net» 2014-09-10 19:43:08 
Parent: Bf187d831250b8e93d3?badilbeifálaaecaS35e (Added information about additional people to be thanked.) 





Parent: 6S3f8?5bSb640f94469066fOb3af43206dd90295 (Lesson 7: Added intro on branching; reformatted the lessons) 
Child: ai!?3fd2a6018e4c39e73181c8e6639e535cb81d (Merge branch 'unmerging') 

Branches: integration-test, master, master.reset, right before merge 

Follows: oscon office hours 

Precedes: 








Merge branch 'video-lessons' into integration-test 








图 9-3; 运行 git bisect visualize 展示 bisect 过 程 的 最 新 状态 


bisect 假定 不 好 的 事情 已 经 发 生 

我 们 假设 当前 的 工作 是 有 问题 的 。 因 此 ， 你 不 能 回 到 过 去 然后 寻找 问题 被 修 
复 的 时 候 ， 而 需要 回 到 过 去 并 找到 出 错 的 地 方 。 如 果 你 试 着 寻找 什么 时 候 加 
入 了 一 个 修复 ， 尽 管 这 是 可 能 的 ， 但 它 看 上 去 会 非常 令 人 困惑 。 你 只 需要 记 
得 对 调 正 确 和 错误 的 定义 。 











9.5 小结 
我 会 愉快 地 承认 我 痴迷 于 犯罪 电视 剧 ， 因 此 本 章 中 使 用 Git 进行 深入 调查 十 分 吸引 我 。 在 
本 章 中 ， 你 接触 到 了 下 面 这 些 我 放 在 侦探 工具 箱 中 的 新 命令 


e stash 允许 你 搁置 你 当前 的 工作 ， 这 样 你 就 可 以 签 出 男 一 个 分 支 了 。 
。 blame 允许 你 查找 一 份 文件 的 逐 行 历史 记录 。 
。 bisect 允许 你 有 条 理 地 查找 历史 记录 ， 来 寻找 出 错 的 地 方 。 


这 些 工具 和 第 6 章 中 从 错误 恢复 的 信息 一 起 ， 将 会 帮助 你 深入 探索 你 可 能 会 遇 到 的 任何 犯 
罪 现 场 并 从 中 恢复 。 
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第 三 部 分 
Git 托 管 平台 





本 书 前 两 部 分 介绍 了 Git 通用 的 命令 ， 而 不 是 针对 任何 一 个 代码 托管 平台 。 在 第 三 部 分 中 ， 
你 将 学 到 三 个 流行 的 协作 平台 : GitHub, Bitbucket 和 GitLab。 在 我 参与 过 的 很 多 项 目 中 ， 
我 发 现 我 的 工作 通常 分 为 三 块 : 在 GitHub 上 托管 的 开源 项 目 ， 在 Bitbucket 上 托管 的 私有 
客户 工作 ， 以 及 GitLab 上 的 内 部 自治 项 目 。 


并 不 存在 任何 正式 的 限制 规定 你 必须 以 这 种 方式 使 用 这 些 系统 。 实 际 上 ，GitHub 也 有 企业 
版 本 ， 人 允许 你 购买 一 个 “本 地 部 署 ” 的 GitHub 示例 ;GitLab 也 有 一 个 社区 版 本 ， 提 供 免 
费 的 私有 和 公开 Git 仓库 的 托管 。 

有 很 多 书 专门 讲述 了 如 何 使 用 这 三 个 平台 中 的 每 一 个 。 后 续 的 每 一 章 并 不 会 尝试 重复 这 
些 工 作 ， 而 是 设计 为 我 最 常见 到 的 这 些 平台 的 用 法 的 “入 门 ”指南 。 第 10 章 介绍 使 用 
GitHub 托管 公开 的 开源 项 目 ， 第 11 章 介 绍 使 用 Bitbucket 托管 私有 的 闭 源 项 目 ， 而 第 12 
章 介绍 使 用 GitLab 托管 私有 的 内 部 仓库 。 

















第 10 章 





GitHub 上 的 开源 项 目 


GitHub 拥有 900 多 万 名 用 户 ， 是 当今 世界 上 最 大 的 代码 托管 平台 。 如 果 你 是 Web F 
者 ， 或 者 正在 参与 开源 软件 的 开发 ， 那 么 你 很 可 能 


码 (如 果 你 没有 创建 账户 并 且 参 与 到 开发 社区 )。 








发 


最 近 访 问 过 GitHub 网 站 来 下 载 一 些 代 





进行 专 有 代码 开发 的 程序 员 可 能 不 习 





A 


了 解 GitHub， 但 这 并 不 妨碍 它 是 一 个 代码 托管 平台 ， 因 为 GitHub 同样 允许 你 创建 私有 仓 


E (如 果 你 不 希望 共享 你 的 代码 )。 


本 章 的 重点 将 是 使 用 GItHub 进行 公开 的 项 目 开发 ， 








的 系统 。 学 完 本 章 ， 你 将 能 够 在 GitHub 上 完成 以 下 事项 。 


。 创建 新 账户 

。 创建 组 织 

。 创建 新 项 目 

。 接纳 新 的 协作 者 的 贡献 
。 接受 协作 者 的 拉 取 请 求 


到 目前 为 止 ， 你 一 直 使 用 的 仓库 样 例 都 托管 在 GitLab 上 。 与 GitLab 不 同 ，GitHub 平台 并 





因为 它 已 经 成 为 大 多 数 新 人 首先 接触 





不 是 开源 软件 。GitHub 这 无 疑问 可 以 提升 你 使 用 Git 的 经 验 ， 但 GitHub 自身 的 一 些 用 途 


有 时 候 会 让 你 难以 分 清 你 什么 时 候 在 使 用 Git 术语 





作为 Web 开发 者 ， 我 可 以 利用 GitHub 的 很 多 很 棒 的 功能 。 


静态 网 站 ， 甚 至 是 基于 HTML 的 幻灯 片 。 使 用 本 





， 什 么 时 候 在 使 用 GitHub 术语 。 











shop.oreilly.com/product/0636920034872.do) 。 
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我 曾经 使 用 GitHub 发 布 简单 的 


之 前 已 讲述 的 相同 方法 ， 你 首先 将 学 习 
如 何在 单 人 团队 中 使 用 GitHub， 然 后 学 习 使 用 它 的 功能 来 与 他 人 协同 。 当 然 ， 如 果 你 已 经 
在 某 个 团队 中 工作 ， 那 么 我 鼓励 你 直接 跳 到 本 章 中 最 适合 你 的 那 一 节 。 


喜欢 通过 视频 教程 学 习 的 读者 可 以 参考 本 书 附带 的 系列 视频 ，Collaborating with Git (http:// 








10.1 开始 使 用 GitHub 


在 本 节 中 ， 你 将 学 习 如 何在 GitHub 上 创建 账户， 并 在 自己 的 GitHub 账户 中 发 布 仓库 。 本 
节 的 目标 是 让 你 熟悉 单 人 团队 中 的 GitHub 使 用 ， 因 此 一 些 操作 可 能 在 参与 大 型 团队 时 会 
感觉 更 加 自然 些 。 


10.1.1 创建 账户 

fr GitHub 上 访问 公开 仓库 不 需要 账户 。 如 果 你 希望 上 传代 码 ， 或 者 参与 代码 的 讨论 ， 那 
么 将 需要 创建 一 个 帐户。 幸运 的 是 ， 设 置 账户 非常 简单 直接 ， 而 公开 的 仓库 是 免费 的 。 一 
个 免费 账户 足够 完成 本 章 中 包含 的 所 有 内 容 。 

$15: 创建 你 的 账户 

(1) 访问 https://github.com (图 10-1)。 

(2) 输 入 一 个 未 被 占用 的 用 户 名 。GitHub 会 告诉 你 这 个 名 称 是 否 已 经 被 使 用 。 

(3) 输入 一 个 合法 的 电子 邮件 地 址 。 

(4) 输入 一 个 安全 的 密码 。 

(5) 点 击 Sign up for GitHub (注册 GitHub 账户 ) 按钮 继续 。 


























GitHub Explore Features Enterprise Blog Sign in 


! 
Build software 


better, together. | 


Powerful collaboration, code review, and code management for 


open source and private projects. Need private repositories? | Seoa | 


for GitHub”, you agree t 


t ated email ccasionally 














& 10-1: 注册 GitHub 账户 
在 完成 用 户 名 是 否 唯 一 、 电 子 邮件 是 否 合法 和 密码 是 否 安全 的 验证 测试 后 ， 你 将 会 进入 下 
一 个 页 面 。 

第 2 步 : 选择 一 个 付费 方案 

此 时 ， 你 可 以 选择 通过 付费 方案 来 花 钱 支持 GitHub。 代 码 托管 服务 毫 无 疑问 是 免费 的 。 默 
认 情 况 下 ，GitHub 为 你 选择 免费 的 方案 (图 10-2) 。 你 需要 遵循 以 下 步骤 。 

D 确认 你 希望 启用 的 方案 类 型 。 默 认 情 况 下 ， 免 费 方 案 是 被 选中 的 。 

(2) 通过 点 击 Finish sign up (完成 注册 ) 完成 账户 创建 过 程 。 




















GitHub 上 的 开源 项 目 | 167 








Welcome to GitHub 


You've taken your first step into a larger world, Ggitforteams. 


Completed ur Step 2: 
Set up a personal account Choose your plan 


Choose your personal plan 
Each plan includes: 


Plan Cost (view in GBP) Private repos 
Unlimited collaborators 
Large $50/month 50 Choose - . 
Unlimited public repositories 
Medium $22/month 20 Choose 
Free setup 
Small $12/month 10 Choose SSL Protection 
Email support 
Micro $7/month 5 Choose 
Wikis, Issues, Pages, & more 
Free $0/month 0 Chosen 
Charges to your account will be made in US Dollars. Converted prices are provided 、 








as a convenience and are only an estimate based on current exchange rates. Local 
pric hange as the exchange rate fluctuates. 
Don't worry, you can cancel or upgrade at any time. 


Help me set up an organization next 

Organizations are separate from personal accounts and are best suited for 
businesses who need to manage permissions for many employees. 

Learn more about organizations. 


&^ 











图 10-2: 为 你 的 GitHub 账户 选择 一 个 方案 


通过 付费 支持 GitHub 运营 

如 果 你 希望 帮助 GitHub 继续 运营 下 去 ， 你 或 许 希望 在 未 来 某 个 时 候选 择 付 
费 方案 。 采 取 付 费 方案 的 好 处 之 一 是 ， 你 可 以 创建 私有 的 仓库 ， 只 有 你 添加 
到 项 目的 开发 者 才能 够 访问 到 。 














在 创建 账户 后 ， 你 就 会 收 到 一 封 来自 GitHub 的 电子 邮件 ， 要 求 你 确认 你 的 电子 邮件 地 址 。 
你 需要 点 击 此 电子 邮件 中 的 链接 来 完成 账户 的 创建 过 程 。 如 果 你 不 验证 电子 邮件 地 址 ， 将 
无 法 完成 某 些 操作 。 

你 现在 可 以 使 用 你 的 账户 来 执行 一 系列 的 操作 ， 包 括 创建 新 的 仓库 ， 向 你 自己 和 其 他 人 的 
仓库 中 贡献 代码 。 

SSH 密 钥 

如 果 你 使 用 一 个 非常 安全 的 密码 ， 那 么 可 能 会 使 用 密码 生成 器 获得 一 个 长 度 为 45 位 ， 包 
括 字 母 、 数 字 和 特殊 字符 的 密码 。 没 有 人 想 要 重复 输入 这 种 密码 ， 但 为 了 授权 上 传 ， 在 将 
代码 上 传 到 GitHub 上 时 系统 会 提示 你 输入 密码 。 通 过 使 用 你 的 SSH 密 钥 来 上 传代 码 ， 你 
可 以 避免 在 每 次 想 要 发 布 代 码 时 重复 输入 密码 。 
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附录 D 包含 了 如 何 创建 并 获取 SSH 密 钥 的 说 明 。 一 旦 你 将 公 钥 复制 到 剪贴 板 后 ， 就 可 以 

继续 回 到 GitHub ， 操 作 步 骤 如 下 所 示 。 

(访问 https://github.com/settings/ssh。 你 也 可 以 登录 账户 ， 点 击 右 上 角 的 设置 齿轮 ， 然后 
从 账户 导航 栏 的 选项 中 点 击 SSH Keys (SSH 258). 

(2) f£ SSH Keys 摘要 页 面 ， 点 击 Add SSH key (添加 SSH 密 钥 ) 。 

(3) 可 选择 是 否 为 你 的 SSH 密 钥 添加 一 个 标题 。 例 如 ， 除 了 为 工作 电脑 生成 的 密 钥 ， 你 可 
能 有 一 组 个 人 SSH 密 钥 。 

(4) 将 你 之 前 复制 的 公 钥 粘贴 到 Key (H) 字段 中 。 

(5) 点 击 Add key. (添加 密 钥 ) 按钮 。 


SSH 密 钥 必须 是 唯一 的 


GitHub 只 会 允许 系统 中 的 密 钥 被 添加 一 次 。 如 果 你 已 经 在 别 的 账户 中 用 过 这 
些 密 钥 ， 那 么 在 尝试 保存 这 些 密 钥 时 会 看 到 一 条 错误 消息 。 





现在 ， 你 可 以 从 你 的 本 地 电脑 中 执行 需要 认证 的 操作 ， 但 不 需要 输入 你 的 GitHub 密码 。 


10.1.2 ”创建 组 织 


假设 你 将 会 进行 一 个 开源 项 目 ， 那 么 现在 或 许 会 想 要 创建 一 个 组 织 。 组 织 能 够 管理 其 中 的 
项 目 。 多 个 项 目 可 以 加 入 (或 被 分 配给 ) 一 个 组 织 。 这 人 允许 你 不 用 创建 另 一 个 GitHub Ik 
户 就 可 以 管理 一 个 项 目 。 组 织 可 以 免费 创建 ， 所 以 你 同样 可 以 利用 它们 。 


为 你 的 组 织 命名 

一 般 来 说 ， 你 将 会 创建 一 个 与 仓库 主 项 目 名 相同 的 组 织 名 称 。 例 如 ， 如 果 你 
当前 仓库 中 可 用 的 库 名 为 evilrooster， 那 么 你 想 要 为 新 的 项 目 账户 保留 的 名 
称 应 该 也 是 evilrooster。 一 旦 新 的 组 织 创 建 后 ， 你 可 以 将 仓库 的 所 有 权 从 你 
的 个 人 账户 转移 到 项 目的 组 织 账 户 。 这 还 将 允许 你 保留 仓库 的 项 目 历史 。 


















































要 创建 一 个 组 织 ， 请 完成 以 下 步骤 。 
(D 从 顶部 的 菜单 中 ， 点 击 头 像 左 边 的 + 符号 。 
(2) 点 击 New Organization (新 建 项 目 )。 你 将 会 被 重新 定向 到 新 组 织 的 设置 表单 。 
(3) 在 Create an organization (创建 新 组 织 ) 的 表单 中 ， 输 入 以 下 信息 。 
* Organization Name (组 织 名 ) : 这 将 会 是 你 项 目 URL 的 一 部 分 。 
* Billing email. (账单 寄 送 电子 邮件 地 址 ) : 即使 你 选择 免费 方案 ， 这 个 字段 也 是 必 填 的 。 
。 Plan (方案 ) : 默认 选择 开源 。 
(4) 点 击 Create organization (创建 组 织 ) 以 继续 。 
在 下 一 个 页 面 中 ， 你 可 以 添加 组 织 的 团队 成 员 。 你 自己 的 账户 已 经 默认 添加 。 为 了 添加 额 
外 的 账户 ， 请 完成 以 下 步骤 。 
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(1) 在 搜索 框 中 ， 输 入 你 想 要 添加 的 成 员 的 名 字 或 用 户 名 。 

Q) 点 击 成 员 名 字 右 边 的 + 符号 。 

(3) 重复 第 (1) 步 和 第 (2) 步 ， 添 加 所 有 成 员 。 

(4) 点 击 Finish (完成 ) 来 发 送 邀 请 。 

你 的 组 织 已 经 创建 完毕 ， 在 你 设置 组 织 时 ， 新 成 员 也 已 添加 完毕 。 


10.1.3 个 人 仓库 

本 节 将 简 述 把 你 自己 的 仓库 放 到 GitHub 上 的 过 程 。 你 将 会 使 用 你 的 个 人 账户 来 创建 一 个 
新 的 仓库 ， 这 适用 于 你 一 般 不 希望 其 他 人 贡献 的 项 目 ， 因 为 这 些 项 目 就 是 你 的 。 例 如 ， 当 
我 发 布 会 议 演讲 中 使 用 的 HTML 演示 文稿 时 ， 通 常会 将 它们 推送 到 GitHub 仓库 来 共享 。 

1. 创建 项 目 

GitHub 上 的 仓库 远 不 止 你 在 本 地 电脑 上 的 目录 中 运行 init 命令 时 得 到 的 Git 仓库 。 它 提 
fit issue 跟踪 工具 ， 能 够 将 Markdown 文件 转换 成 网 页 ， 还 有 附带 的 Wiki 页 面 、 图 表 等 。 
然而 ，GitHub 仍然 将 这 个 过 程 称 为 创建 仓库 。 


要 想 开始 创建 新 仓库 的 过 程 ， 找 到 并 点 击 屏幕 右上 角 的 + 图 标 ， 然 后 选择 New repository 
(新 建仓 库 ， 图 10-3), 





















































gitorteams 十 ~ QD Ù | 


New repository 


eco " 
SSH Probl New organization 








10-3: 创建 一 个 新 仓库 

或 者 ， 你 可 以 登录 并 前 往 GitHub 首页 ， 然 后 找到 并 点 击 Create new repository (新 建仓 库 ) 
按钮 。 

一 旦 你 开始 了 这 个 流程 ， 就 会 来 到 一 个 页 面 ， 你 需要 在 该 页 面 上 填写 项 目的 详细 信息 ( 
10-4)。 表 10-1 总 结 了 你 需要 的 信息 。 

















图 
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Owner 


gittoteams ~  / 


Great repository names ar 


Description (optiona 


Public 
Anyone can see this 


Private 


Repository name 


e short and memorable. Need inspiration? How about freezing-batman. 


repository. You choose who can commit 


You choose who can see and commit to this repository. 


Initialize this repository with a README 
This will let you immediately clone the repository to your computer. Skip this step if you're importing an existing repository. 


None ~ 





None ~ 





图 10-4: 输入 新 仓库 的 详细 信息 
表 10-1: 用 于 新 建 GitHub 仓 库 时 需要 的 详细 信息 



























































字段 备注 导入 时 是 否 需 要 ? 

Repository name (仓库 名 称 ) 你 的 新 项 目 可 以 在 https://github.com/<username>/<repo- 是 
name> 这 个 URL 上 访问 到 。 请 选择 短小 精炼 的 名 称 

Description. (仓库 描述 ) 在 仓库 主页 顶端 ， 文 件 列 表 之 上 显示 的 文本 是 

Visibility (可 见 性 ) 选择 Public (公开 ， 默 认 选 项 ) 或 Private (MA, 是 
要 付费 账户 ) 

Initialize this repository with a 添加 一 个 空 文件 ， 描 述 项 目的 详细 信息 。 这 个 文件 否 

README (初始 化 仓库 时 添加 将 会 在 你 的 仓库 首页 演 染 成 HTML， 但 可 以 使 用 

README 文件 ) Markdown 编写 

Add .gitignore (添加 .gitignore) 很 多 编程 语言 会 在 构建 过 程 中 生成 不 该 引入 仓库 的 编 否 
译文 件 。 你 可 以 现在 生成 一 个 .gitignore 文件 ， 其 中 包 
含 你 使 用 的 语言 中 常见 的 文件 扩展 

Addlicense (添加 许可 证 ) 如 果 没 有 许可 证 文件 ， 你 没有 给 人 们 下 载 并 使 用 你 的 可 能 














代码 的 权限 。 你 保留 全 部 版 权 ， 不 授权 别人 使 用 你 
的 工作 。 理 想 情况 下 ， 你 的 项 目 需要 包括 一 份 许可 
证 。 如 果 你 不 确定 选择 哪 一 个 ， 选 择 许可 证 (http:/ 
choosealicense.com/) 能 够 帮助 你 














如 果 你 已 经 在 本 地 创建 了 一 个 仓库 ， 则 可 以 选择 将 它 上 传 到 这 个 新 项 目 中 ， 但是， 如 果 你 





在 初始 化 过 程 中 创建 了 文 们 








库 ， 那 么 将 会 忽略 READM 


F， 那 么 将 需要 首先 下 载 这 些 更 改 ， 将 它们 并 入 你 的 本 地 仓库 ， 








E、.gitignore 和 许可 证 文件 的 创建 。 


然后 再 将 它们 推送 回 GitHub。 为 了 避免 额外 的 这 一 步 ， 如 果 我 已 经 在 本 地 拥有 了 一 个 仓 
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一 旦 你 填写 了 表 10-1 中 每 一 项 的 值 ， 找 到 并 点 击 Create repository (创建 仓库 ) 按钮 。 你 





的 新 仓库 将 会 被 创建 ， 而 你 将 会 来 到 摘要 页 面 ， 该 页 面 上 将 显示 关于 下 一 步 该 怎么 做 的 建 








ix (图 10-5), 























gitforteams / freezing-batman 


Quick setup — if you've done this kind of thing before 


We recommend every repository include a README, LICENSE, and .gitignore. 


...Or create a new repository on the command line 


echo "# freezing-batman" >> README.md 

git init 

git add README.md 

git commit -m "first commit" 

git remote add origin https://github.com/gitforteams/freezing-b 
git push -u origin master 


.Or push an existing repository from the command line 
git remote add origin https://github.com/gitforteams/freezing-b 


git push -u origin master 


...Or import code from another repository 
You can initialize this repository with code from a Subversion, Mercurial, or TFS project. 


Import code 





lam Set upin Desktop Or HTTPS SSH https://github.com/gitforteams/freezing-batman.git 


@Unwatchv 1 会 Star 0 
€» Code 
& 
ES 0 
Pull req. 9 
e 
& 
Pul 
atman.git 
ttings 
atman.git & 








10-5: 你 的 新 仓库 已 经 可 用 
因为 在 仓库 的 创建 过 程 中 没有 初始 化 任何 文件 ， 所 














以 你 目前 只 有 两 个 选项 : 从 你 的 本 地 电 


脑 上 传 一 个 仓库 ， 或 者 通过 一 个 公开 可 访问 的 URL 导入 项 目 。 例 如 ， 如 果 你 想 要 复制 本 


书 之 前 使 用 的 GitLab 项 目 ， 那 么 可 以 这 么 做 。 我 们 
2. 导入 仓库 














接 下 来 介绍 这 些 选 项 。 





如 果 你 遵循 了 本 书 之 前 的 步 又， 那么 应 该 已 经 创建 了 一 个 GitLab 仓库 ， 克 隆 了 “Git 团队 
协作 ”工作 坊 的 文件 。 你 可 以 轻松 地 将 这 个 仓库 导入 GitHub。 只 有 当 你 的 GitHub 仓库 中 








没有 文件 时 ， 你 才 可 以 完成 这 个 过 程 ， 如 下 所 示 。 
(1) 访问 你 的 项 目 主页 。 











(2) 如 果 仓 库 是 空 的 ， 你 可 以 找到 并 点 击 Import code (导入 代码 ) 按钮 。 点 击 这 个 按钮 将 


会 打开 GitHub 导入 工具 。 
(G3) 输 入 你 想 要 输入 的 仓库 URL。 它 必须 是 一 个 公 居 


F 项 目 ， 但 并 非 必须 是 一 个 Git 仓库 。 你 





还 可 以 导入 Subversion 和 Mercurial 仓库 。 如 果 




















尔 在 导入 一 个 Git 项 目 ， 请 确保 你 输入 





了 完整 的 URL， 包 括 .git 扩展 名 ， 这 个 URL 结构 与 你 想 要 在 本 地 克隆 仓库 时 使 用 的 相 
同 。 图 10-6 显示 了 一 个 项 目的 合法 URL (https:/gitlab.com/gitforteams/gitforteams.git) 。 





(4) 点 击 Begin import. (开始 导入 )。 导 入 流程 将 会 开始 。 





(5) 当 导 入 过 程 完 成 后 ， 点 击 Continue to repository 
中 导入 (图 10-7)。 














(进入 仓库 )。 你 的 文件 将 会 从 远程 仓库 
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GitHub Importer Cancel 


Importing into gitforteams / freezing-batman 


Enter the URL of the repository you'd like to import. This should be the URL you use to clone or 
check out your code. 


https://gitlab.com/gitforteams/gitforteams.git 


Examples 

http//example.com/svn/ <= Don't include “trunk” or "branches 
http//example.com/hg 

https //tfs.example.com/tfs <= We'll figure out which project next 





图 10-6: 输入 Git 仓库 的 合法 URL 来 将 它 导 入 GitHub 

















gitforteams /freezing-batman @uUnwatchv 1 Star 0  WFork 0 
Website 
ription of this repository Website for this repository (optional) Save orCancel 《> Code 
© Issues 9 
148 commits 4 branches 4 contributors 
I^ Pull requests 0 
Your recently pushed branches: 
29 Wiki 
V sandbox (less than a minute ago) 
Vb 1-bad. Jokes (less than a minute ago] 4 Pulse 
[a | Pbranch: master»  freezing-batman /+ = iu Graphs 
Changes to "Undo" graphic: add credits, add license, clean export == 
X Settings 
Byl gittorteams authored 19 days ago latest commit 2db982dbfd © 
lli handouts OSCON webinar updates. 6 months ago 。 Mrrps cione URL 
ili lessons Lessons were renumbered to match O'Reilly conventions. 2 months ago s://github.cor | É& 
lill resources Changes to "Undo" graphic: add credits, add license, clean export 19 days ago You can clone wiih HTTPS, SSH, 
or Subversion. © 
lil slides Resolving merge conflict; fixing broken link 2 months ago 
Clone in Desktop. 
B .gitignore Ignoring swap files from vim. 6 months ago 
«p» Download ZIP 
EB README.md Add a line to Readme. 2 months ago 
README.md 


Git for Teams of One or More 








图 10-7: 仓库 文件 和 历史 已 经 成 功 从 GitLab 导入 GitHub 
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3. 连接 本 地 仓库 

在 第 7 章 中 ， 你 学 会 了 如 何 连接 本 地 仓库 和 GitLab 上 的 一 个 新 的 远程 仓库 。 我 们 会 在 这 
里 为 新 的 GitHub 仓库 重复 这 个 过 程 。 如 果 在 初始 化 过 程 中 没有 创建 文件 ，GitHub 会 在 项 
目 主 页 上 提供 一 组 可 以 直接 复制 粘贴 的 命令 来 完成 这 些 步 又。 远程 仓库 的 结构 为 https:/ 
github.com/<username>/<repo-name>.git。 例 如 ， 我 使 用 GitHub 给 我 的 样 例 名 称 (glowing- 
octo-dangerzone) 和 账户 名 gitforteams 创建 了 一 个 新 仓库 。 如 果 我 接 下 来 想 将 我 自己 的 电脑 
中 的 一 个 仓库 和 这 个 仓库 连接 ， 那 么 将 会 完成 例 10-1 中 概述 的 步骤 。 


例 10-1 克隆 仓库 


$ git remote add origin https://github.com/gitforteams/glowing-octo-dangerzone.git 


一 旦 你 在 完成 了 这 些 步 又 之 后 访问 项 目 主 页 ， 就 会 看 到 所 有 文件 已 经 上 传 。 现 在 ， 你 可 以 
开始 在 你 的 GitHub 仓库 中 工作 。 

4. 将 更 改 发 布 到 你 的 GitHub 仓 库 

一 旦 连接 了 你 的 本 地 仓库 和 GitHub 仓库 ， 你 就 可 以 使 用 push 命令 ， 将 提交 的 更 改 上 传 至 
任何 跟踪 分 支 。 为 了 在 GitHub 上 发 布 一 个 新 的 分 支 ， 你 需要 明确 告诉 Git 你 想 将 哪个 远程 
作为 你 的 上 游 分 支 ( 例 10-2). 


例 10-2 设置 远程 仓库 中 的 上 游 分 支 

$ git push --set-upstream origin master 
在 设置 了 上 游 连接 之 后 ， 你 不 需要 再 次 添加 --set-upstrean 命令 。 如 果 你 希望 将 你 的 更 改 
发 布 到 一 个 以 上 的 远程 仓库 ， 则 需要 继续 指定 使 用 的 远程。 


5. 在 网 页 上 进行 提交 

使 用 GitHub 这 样 的 代码 托管 平台 (而 不 仅仅 是 命令 行 ) 的 好 处 之 一 是 ， 系 统 自 带 了 一 些 

微小 的 改进 。 例 如 ，GitHub 允许 你 通过 Web 用 户 界面 编辑 任何 仓库 中 的 文件 。 尽 管 我 推 

荐 你 不 要 将 它 当 作 你 的 日 常 代码 编辑 器 ， 但 如 果 你 只 是 想 修复 一 次 草率 的 提交 中 的 一 个 拼 

写 错误 ， 这 会 非常 方便 。 

为 了 在 Web 编辑 器 中 进行 编辑 ， 你 需要 完成 以 下 步骤 。 

(访问 你 想 要 编辑 的 特定 文件 。 这 个 文件 的 URL 将 会 包含 分 支 名 。 例 如 ，https://github. 
com/gitforteams/freezing-batman/blob/master/README. md, 

(2) 找 到 并 点 击 铅 笔 图 标 来 编辑 文件 (图 10-8)。 或 者 ， 在 键盘 上 按 下 e。 


你 将 来 到 一 个 基于 浏览 器 的 文本 编辑 器 (图 10-9)。 现 在 ， 你 可 以 修改 仓库 中 的 这 个 文件 。 


在 编辑 完成 后 ， 你 可 以 点 击 Preview changes (预览 更 改 ) 按钮 。 新 增 的 行 中 ， 更 改 的 文本 
左边 有 一 个 绿色 的 长 条 (GARE HTML 元 素 ins 中 ) ， 被 移 除 的 行 左 侧 有 一 个 红色 的 长 条 
(BRE HTML 元 素 del H), ÆR 10-10 中 ， 第 一 段 长 条 标记 的 段落 被 删除 了 ， 第 二 个 段 
落 是 新 增 的 。 除 了 颜色 和 HTML 元 素 ， 似 乎 没有 什么 方法 可 以 更 好 地 标识 新 增 和 移 除 的 内 
容 差 异 。 
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p branch: master» — freezing-batman / README.md 





o 


Bi xrmxrm on Jan 24 Add a line to Readme. 


2contibuors 回力 


54lines (39 sloc) 2.197 kb Raw Blame History = f 


mi 


Git for Teams of One or More ^ 


Supporting files for workshops and sessions about creating a developer work flow for your project (and your team) with 
the version control system, git. Basis of ORM video course 


Contents 


/slides 
Reveal.js slides for various workshops and conference sessions. 


* 2014: LoneStar PHP 
^ one-page summary 
o slide deck 
o PDF slides 











图 10-8: 你 可 以 点 击 铅笔 图 标 来 编辑 任何 文本 文件 





freezing-batman / README.md 





or cancel 


《> Edit file €» Preview changes Spaces [Ej 2 [B setwae u 


1 Git for Teams of One or More 





4 Supporting files for workshops and sessions about creating a 
developer work flow for your project (and your team) with the 
version control system, git. 

Basis of ORM video course 

10- ## Contents 


12  x/slides* 


14 Reveal.js slides for various workshops and conference sessions. 





16 - 2014: LoneStar PHP 
7 ~ [one-page summary] (slides/slides/session-lonestarphp-strategy.md) 
18 - [slide deck] (http: //emmajane.github. io/gitforteams/slides/slides/session-lonestar.html) 





- [PDF slides](http://emmajane.github.io/gitforteams/handouts/slides-gitforteams-lonestarphp.pdf) 
2 2014: OSCON workshop 

21 -~ [one-page summary](slides/slides/workshop-oscon-gitforteams.md) 

22 - [slide deck] (http: //emmajane.github. io/gitforteams/slides/slides/workshop-oscon.html) 

23 - [PDF slides](http://emmajane.github.io/gitforteams/handouts/slides-gitforteams-oscon.pdf) 

















x/resourcesx 





27 The following work flow documents are referenced in the presentation: 














图 10-9. 带 有 可 选 预览 的 基于 浏览 器 的 文本 编辑 器 





GitHub 上 的 开源 项 目 


175 





<>» Edit file G Preview changes Spaces W 2 Ð swa B Z 


Git for Teams of One or More 


Supporting files for workshops and sessions about creating a developer work flow for your project (and your team) 
with the version control system, git. Basis of ORM video course 


This is a new description of the repository. 








10-10: MARRI METRES (B—TRBR, METRA) 


一 旦 文件 中 的 编辑 完成 后 ， 你 就 可 以 将 更 改 提 交 回 你 的 仓库 (图 10-11)。 短 提交 说 明 提 供 
了 默认 值 ， 表 明文 件 的 状态 更 新 。 您 应 该 对 所 做 编辑 进行 更 具 描 述 性 的 描述 。 你 也 可 以 添 
加 一 段 可 选 的 扩展 说 明 。 你 需要 决定 是 希望 将 更 改 提交 到 当前 分 支 ， 还 是 希望 为 这 个 更 改 
创建 一 个 拉 取 请 求 。 默 认 情况 下 ，GitHub 假设 你 想 要 直接 将 更 改 提 交 到 仓库 中 的 同一 分 支 。 














Commit changes 


© © Commit directly to the master branch 


Create a new branch for this commit and start a pull request. Learn more about pull requests. 


Cancel 











10-11; 将 你 的 更 改 提交 回 仓库 


因为 你 正在 你 自己 的 仓库 中 工作 ， 所 以 将 更 改 提 交 到 master 分 支 没 什么 关系 。 选 择 默 认 
值 ， 然 后 点 击 Commit changes (提交 更 改 )。 


你 为 什么 可 能 会 想 要 给 自己 提交 一 个 拉 取 请 求 

如 果 你 是 项 目 唯一 的 编辑 者 ， 则 可 能 不 需要 为 你 的 更 改 创建 拉 取 请 求 。 然 
而 ， 拉 取 请 求 并 入 master 分 支 时 会 使 用 - -no-ff 参数 。 这 意味 着 在 图 形 化 
的 历史 记录 中 ， 它 将 会 出 现在 master 分 支 的 直线 历史 记录 外 。 如 果 你 不 介 
意 这 个 提交 只 出 现在 主 分支 上 ， 那 么 省 略 拉 取 请 求 这 一 步 是 无 所 谓 的 。 创 建 
和 关闭 拉 取 请 求 的 步骤 说 明 将 在 本 章 后 续 部 分 中 介绍 。 























一 旦 你 将 更 改 提交 到 仓库 之 后 ， 就 需要 更 新 你 的 本 地 仓库 来 查看 这 些 更 改 。 


6. 更 新 你 的 本 地 仓库 

如 果 你 确实 使 用 基于 Web 的 编辑 器 更 新 了 分 支 ， 那 么 你 的 本 地 分 支 将 会 过 时 。( 不 要 尝试 
在 你 的 本 地 分 支 上 重 做 相同 的 编辑 ，Git 需要 同一 时 刻 完全 一 致 的 提交 来 知道 两 个 提交 是 
同一 个 。) 你 需要 下 载 这 些 更 改 ， 并 在 GitHub 允许 将 新 的 更 改 上 传 之 前 ， 将 它们 整合 到 你 
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的 本 地 仓库 。 你 可 以 使 用 下 面 的 顺序 来 完成 这 一 步 。 
你 应 该 从 你 本 地 的 项 目 仓库 目录 中 开始 。 接 下 来 ， 确 保 你 正在 使 用 与 远程 编辑 相同 的 分 
支 。 此 分 支 很 可 能 就 是 master 分 支 ， 如 下 所 示 。 

$ git checkout master 
接 下 来 ， 将 远程 的 更 改 并 入 你 的 本 地 工作 。 因 为 这 些 更 改 被 复制 到 了 同一 个 分 支 ， 而 且 这 
些微 小 的 更 改 不 是 新 的 功能 ， 所 以 我 会 使 用 - -rebase 而 不 是 merge 选项 来 并 入 这 些 更 改 。 
这 将 保持 图 形 化 的 历史 记录 便于 阅读 ， 如 下 所 示 。 


$ git pull --rebase-preserve 


你 的 本 地 分 支 应 该 已 是 最 新 的 ， 准 备 好 进行 新 的 工作 。 


10.2 ”使 用 GitHub 上 的 公开 仓库 


在 为 项 目 工 作 时 ， 你 可 以 选择 下 载 一 份 文件 的 压缩 包 ， 或 者 维持 一 个 远程 仓库 的 连接 ， 
在 新 的 更 改 存在 时 下 载 ， 并 将 你 可 能 的 更 改 贡 献 回 项 目 。 你 将 学 到 如 何 使 用 
GitHub 上 的 项 目 ， 而 不 是 提交 贡献 。 后 者 将 在 下 一 节 中 介 


10.2.1 下 载 仓库 快照 


随 着 你 的 Git 超 能 力 不 断 增长 ， 你 将 会 更 少 从 GitHub 下 载 压 缩 包 。 如 果 你 希望 将 代码 共享 
给 想 要 zip 压缩 包 的 人 (或许 其 至 是 你 自己 的 项 目 )， 那 么 仍然 可 以 使 用 这 个 选项 。 
为 了 下 载 项 目的 zip 压缩 包 ， 你 需要 完成 以 下 步骤 。 


(访问 你 想 要 下 载 代码 的 项 目 页 面 。 
(2) 找 到 并 点 击 Download ZIP (下 载 压缩 包 )。 这 个 按钮 (图 10-12) 通常 位 于 本 地 克隆 
URL 旁边 ， 或 者 位 于 GitHub 桌面 应 用 (适用 于 Windows 和 OS X) 中 















































HTTPS 


(m 


You can clone with HTTPS, SSH, 


or Subversion © 
[æ Clone in Desktop 


[e Download ZIP 











图 10-12: 下 载 一 份 仓库 快照 


下 载 的 文件 压缩 包 将 根据 你 下 载 的 项 目 和 分 支 命 名 。 要 想 更 改 你 下 载 的 分 支 ， 请 完成 以 下 
步骤 。 


(1) 找到 并 点 击 仓库 主 页 左上 方 的 分 支 下 拉 菜 单 





一 、 





图 10-13), 
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(2) 选择 你 想 要 下 载 的 分 支 。 等 待 页 面 刷新 。 
(3) 找到 并 点 击 Download ZIP (下 载 压缩 包 ) 按钮 。 





gitforteams / freezing-batman 


Description 


148 commits 4 5 branches 


p branch: master ~ | freezing-batman /1 


Switch branches/tags 


Chant n 


E hc 
Branches Tags 


Ei re zl 
gitforteams-patch-1 


lll sli [i 
- master 


sandbox 二 一 


video-lessons 


à 


四 mD 


D 











图 10-13. 首先 选择 一 个 不 同 的 分 支 ， 以 改变 下 载 的 分 支 
用 户 界面 上 不 会 提示 你 正在 下 载 不 同 的 分 支 ， 但 是 ， 文 件 名 将 会 反映 分 支 的 名 字 (repository 


name-branch_name.zip) è 


10.2.2 ”在 本 地 工作 


连接 到 别人 的 GitHub 项 目的 流程 与 使 用 你 自己 的 项 目 几 乎 完全 相同 ， 除 了 你 没有 那个 项 
目的 写 入 权限 之 外 (当然 ， 除 非 你 被 添加 到 那个 项 目 团队 )。 在 本 节 中 ， 你 将 会 学 到 如 
何 创 建 一 个 本 地 克隆 。 我 使 用 这 个 技巧 来 编写 “Git 团队 协作 ”网 站 (http://gitforteams. 
com/) ， 此 网 站 使 用 静态 网 站 生成 工具 Sculpin, 





Sculpin AT] 

Sculpin 是 一 个 使 用 PHP 构建 的 静态 网 站 生成 工具 。 本 节 中 的 说 明 尚 不 足 
以 让 你 能 够 运行 一 个 网 站 。 如 果 你 对 堂 试 Sculpin 有 兴趣 ， 请 从 入 门 指南 
(https://sculspin.io/getstarted/) 开始 学 习 。 








在 这 种 情况 下 ， 我 希望 在 网 站 中 使 用 Sculpin 模板 的 本 地 副本 。 尽 管 我 是 Sculpin 项 目的 志 
愿 者 ， 这 个 仓库 只 是 针对 我 的 网 站 的 。 我 不 可 能 在 本 地 副本 中 为 项 目 做 出 贡献 。 然 而 ,我 
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仍然 希望 保持 一 个 主 项 目的 连接 ， 以 便 轻 松 地 将 最 新 的 更 新 加 入 我 的 网 站 。 尽 管 这 些 命令 
特定 于 Sculpin 项 目 ， 但 你 也 可 以 使 用 你 的 项 目 来 赫 换 URL, 


第 一 步 是 创建 一 份 项 目的 本 地 克隆 〈 例 10-3) ， 如 下 所 示 。 


(1) 前 往 你 想 要 下 载 的 仓库 的 项 目 主 页 。 

(2) 找到 并 点 击 “复制 到 剪贴 板 ” 图 标 (图 10-14) 以 获得 仓库 URL, 

(3) 打开 一 个 命令 窗口 GX Windows 上 的 Git Bash 窗口 ) ， 前 往 你 想 要 将 项 目下 载 到 的 目录 。 

(4) 使 用 clone 命令 和 你 在 第 2 步 中 复制 的 URL 来 创建 一 份 项 目 仓库 的 本 地 副本 。 可 选 地 ， 
将 目录 名 称 添加 到 命令 未 尾 。 

(5) 将 目录 名 称 改 为 项 目 相 关 的 名 称 。 你 也 可 以 通过 在 上 一 步 中 在 命令 末尾 添加 新 目录 的 名 
称 来 完成 这 一 步 。 

(6) 前 往 本 地 仓库 。 


例 10-3 创建 仓库 的 克隆 
$ git clone https://github.com/sculpin/sculpin-blog-skeleton.git 
$ mv sculpin-blog-skeleton gitforteams.com 
$ cd gitforteams.com 











HTTPS 


[PH 


You can clone with HTTPS, SSH, 


or Subversior © 
(ag Clone in Desktop 
EL 


d» Download ZIP 











图 10-14:“ 复 制 到 募 贴 板 ” 图 标 位 于 下 载 按钮 下 方 


第 二 步 ( 例 10-4) 创建 了 一 个 上 游 ， 或 者 说 “供应 商 分 支 "， 它 将 独立 于 你 项 目 中 特有 的 
更 改 。 你 可 以 通过 这 个 分 支 来 更 新 主 项 目的 任何 更 改 。 对 于 我 正在 进行 的 项 目 ， 它 的 默认 
分 支 是 master。 你 可 以 选择 更 适合 你 的 名 称 ， 有 了 时 我 使 用 项 目 名 称 ， 有 时 我 使 用 通用 的 别 
名 upstream。 我 不 认为 使 用 哪 一 个 更 好 (尽管 Shakespeare 会 对 我 的 命名 怪 竟 有 意见 )。 通 
过 移动 分 支 而 不 是 新 建 一 个 分 支 ， 我 维持 了 本 地 分 支 和 远程 仓库 的 关系 。 如 果 你 倾向 于 在 
主 分 支 上 工作 ， 那 么 也 可 以 选择 重新 创建 master 分 支 。 


例 10-4 创建 一 个 上 游 分 支 
$ git branch --move master upstream 
$ git checkout -b master 


最 后 一 步 是 为 项 目的 工作 副本 添加 一 个 远程 仓库 〈 例 10-5)。 这 个 新 的 远程 仓库 将 会 存放 
所 有 你 在 你 的 项 目 实例 中 做 出 的 更 改 。Sculpin 项 目 不 应 该 记录 所 有 我 为 “Git 团队 协作 ” 
网 站 做 出 的 更 改 ， 但 我 需要 跟踪 这 些 更 改 。 在 现实 中 ， 我 在 Bitbucket 上 以 私有 仓库 的 方式 
保存 “Git 团队 协作 ”仓库 。 我 不 使 用 issue 跟踪 工具 ， 而 只 是 在 仓库 中 丢掉 这 些 更 改 ， 然 
































GitHub 上 的 开源 项 目 | 179 











后 在 提交 后 上 传 ， 就 像 一 个 备份 方案 一 样 。 我 没有 利用 Bitbucket 提供 的 功能 ， 但 这 能 让 我 
不 用 过 多 思 萎 。 


当 第 一 次 克隆 项 目 时 ， 远 程 名 称 origin 被 分 配给 远程 仓库 。 我 们 将 要 交换 upstream 的 别 
名 ， 因 为 约定 是 使 用 origin 作为 最 接近 我 们 自己 的 仓库 的 别名 。 

为 了 准备 添加 新 的 远程 ， 你 将 需要 确定 它 的 URL。 如 果 你 现在 还 没有 设置 一 个 远程 仓库 ， 
请 遵循 本 章 之 前 的 创建 项 目的 步骤 ， 并 确保 项 目 在 初始 化 过 程 中 没有 添加 任何 文件 。 一 旦 
你 创建 完 新 项 目 ， 请 遵循 屏幕 上 的 说 明 来 添加 仓库 中 的 远程 信息 ， 然 后 上 传 更 改 。 例 如 ， 
如 果 你 的 GitHub 用 户 名 是 gitforteams， 而 你 的 新 仓库 的 名 称 是 superhero-freda， 那 么 你 需 
要 按照 例 10-5 中 那样 添加 远程 仓库 。 


例 10-5 为 工作 副本 添加 一 个 远程 仓库 
$ git remote rename origin upstream 
$ git remote add origin https://github.com/gitforteams/superhero-freda.git 
$ git push -u origin master 


现在 ， 你 同时 拥有 一 个 名 为 upstrean 的 分 支 和 一 个 名 为 upstream 的 远程 仓库 。 

定期 检查 上 游 仓 库 以 获得 更 新 〈 例 10-6) 。 签 出 你 为 项 目 分 配 的 上 游 分 支 并 拉 取 更 改 以 完 
成 这 一 步 。 

例 10-6 检查 上 游 分 支 以 获得 更 新 


$ git checkout upstrean 
$ git pull --rebase=preserve 


假设 主 项 目 有 更 新 ， 你 可 以 阅读 这 些 更 改 来 决定 是 否 想 要 将 这 些 更 改 并 入 你 自己 的 项 目 
( 例 10-7)。 


例 10-7 比较 上 游 的 更 改 和 你 本 地 的 工作 


$ git diff master upstream 


或 者 你 可 以 在 log 命令 后 添加 一 些 华丽 的 参数 ， 查 看 特定 提交 的 摘要 ， 如 下 所 示 。 


$ git log --cherry-mark --left-right --oneline master...upstream 


我 们 以 前 看 到 过 这 个 命令 的 变种 ， 真 正 新 鲜 的 是 --cherry-mark --left-right。 这 些 参 数 
在 提交 开头 添加 一 个 符号 ， 表明 这 个 更 改 是 列表 中 第 一 个 分 支 ( 向 左 ) 还 是 第 二 个 分 支 
(向 右 ) 引入 的 。 

且 你 理解 了 这 些 更 改 ， 你 就 可 以 更 新 你 的 分 支 ， 与 上 游 更 改 保持 一 致 〈 例 10-8)。 如 
更 改 已 经 存在 ， 而 你 今天 的 工作 尚未 开始 。 换 句 话说， 你 应 该 通过 将 上 游 仓 库 上 的 更 改变 
基 到 你 自己 的 分 支 上 ， 来 更 新 你 的 工作 分 支 。( 像 我 之 前 提 到 的 ， 如 果 你 单独 工作 ， 那 么 
同样 可 以 使 用 合并 ， 如 果 你 觉得 这 比 rebase 更 容易 使 用 ， 我 不 做 评判 。) 

例 10-8 并 入 上 游 更 改 


$ git checkout master 
$ git rebase upstream 


如 果 冲 突 发 生 ， 每 次 解决 一 个 。 第 6 章 还 介绍 了 其 他 处 理 变 基 冲 突 的 建议 。 
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10.3 为 项 目 做 出 贡献 


你 已 经 决定 更 进一步 ， 向 项 目 提交 一 个 贡献 。 很 好 ! RER 这 和 你 之 前 所 做 的 并 没有 很 
大 的 不 同 。 主 要 的 区 别 在 于 你 将 提交 一 个 拉 取 请 求 ， 在 合并 到 主 项 目前 要 经 由 其 他 人 评审 。 


10.3.1 使 用 issue 跟 踪 更 改 
在 公开 项 目 中 ，issue 通常 被 找到 bug 的 用 户 打 开 。 很 少 的 一 些 贡 献 者 会 创建 issue 来 记录 
他 们 想 要 贡献 的 新 功能 ， 或 者 他 们 在 开发 时 感 兴趣 的 设计 更 改 。 

派生 项 目的 issue 是 默认 关闭 的 


对 于 仓库 间 的 派生 ，issue 是 默认 关闭 的 。 如 果 你 想 要 跟踪 你 的 派生 项 目的 
issue， 可 以 在 设置 页 中 启用 这 项 功能 。 


























要 创建 一 个 issue， 请 完成 以 下 步骤 。 

(1) 前 往 项 目 页 面 。 

D 找到 并 点 击 标签 为 Issues 的 选项 卡 。 该 选项 卡 位 于 顶部 的 导航 栏 中 (图 10-15)。 系 统 会 
将 你 重 定向 到 issue 页 面 。 

(3) 找到 并 点 击 New issue (新 建 issue) 按钮 。 该 按钮 位 于 屏幕 的 右 侧 (图 10-16)。 系 统 会 
将 你 重 定向 到 一 个 issue 创建 表单 。 

(4 输入 标题 、 想 要 解决 的 问题 的 描述 (图 10-17) 和 提交 这 个 拉 取 请 求 要 解决 的 issue 的 

单 编 号 。 描 述 问 题 时 越 具 体 ， 它 越 有 可 能 得 到 解决 。 

(5) 当 你 对 你 的 issue 描述 满意 时 ， 找 到 并 点 击 Submit new issue. (提交 新 issue) 按钮 。 
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图 10-15; Issues 的 导航 图 标 
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10-16; $È issue 的 导航 按钮 


Diagrams are only available in English 


Write Preview CD Markdown supported £X Edit in fullscreen 





The diagrams for "un-merging branches" and "undoing mistakes" are only available in English. These 
diagrams should also be available in other languages. 














& 10-17: 新 建 一 个 issue 


在 issue 创建 后 ， 你 现在 可 以 继续 创建 解决 这 个 issue 的 拉 取 请 求 。 


10.3.2 ”派生 项 目 
如 有 果 你 想 要 将 你 的 更 改 贡 献 回去 ， 需 要 完成 以 下 步骤 。 


(1) 前 往 项 目 页 面 。 

(2) 找到 并 点 击 Fork. (派生 ) 按钮 。 仓 库 将 会 被 派生 ， 而 你 将 会 在 你 自己 的 账户 下 看 到 
个 仓库 的 副本 。 

现在 ， 你 可 以 将 项 目的 这 个 副本 克隆 到 你 的 本 地 计算 机 ， 就 像 你 在 10.1.3 节 中 所 做 的 那 

样 。 一 旦 仓库 下 载 后 ， 你 可 以 在 项 目 中 进行 更 改 ， 将 它们 提交 到 你 的 仓库 ， 然 后 将 它们 推 

送 回 你 的 远程 仓库 的 派生 副本 。 

一 旦 你 想 要 合并 到 主 项 目的 这 些 更 改 被 推送 回 GitHub 之 后 ， 你 就 需要 创建 一 个 拉 取 请 求 。 


10.3.3 创建 拉 取 请 求 


当 你 创建 项 目 派 生 时 ，GitHub 维护 了 一 个 上 游 项 目的 连接 。 这 人 允许 你 轻易 地 将 你 派生 仓库 
中 的 更 改 发 送 到 主 项 目 。 
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要 发 起 拉 取 请 求 ， 请 完成 以 下 步骤 。 


(1) 前 往 你 派生 的 仓库 的 项 目 页 面 。 

(2) 找到 并 点 击 拉 取 请 求 按钮 (图 10-18)。 该 按钮 位 于 项 目 描述 的 左上 方 ， 标 题 的 下 方 。 
系统 会 将 你 重 定向 到 可 用 于 拉 取 请 求 的 分 支 摘要 。 如 果 没 有 显示 四 个 下 拉 菜 单 ， 在 继续 
前 点 击 compare across forks (在 派生 间 比 较 )。 

(3) 在 分 支 列表 中 ， 从 最 后 的 下 拉 菜 单 中 选择 你 想 要 提交 到 上 游 项 目的 选项 (图 10-19)。 
你 的 分 支 和 上 游 分 支 间 的 差异 将 会 显示 。 

(4) 找到 并 点 击 Create pull request. (创建 拉 取 请 求 ) 按钮 (图 10-20) 。 一 个 新 的 表单 将 会 打 
JF. 

(5) 输 入 标题 和 一 段 你 为 什么 向 项 目 提交 这 个 更 改 的 描述 (图 10-21). 

(6) 找到 并 点 击 Create pull request 按钮 来 完成 让 你 的 更 改进 入 上 游 项 目的 请 求 。 





























bp branch: master v 











图 10-18: 拉 取 请 求 按钮 位 于 项 目标 题 下 方 





Comparing changes 


Choose two branches to see what's changed or to start a new pull request. If you need to, you can also compare across forks 


w base fork: gitforteams/freezing-batman ~ base: master v id fork: gitforteams/freezing-batman ~ are: master v 











& 10-19: 在 拉 取 请 求 中 选择 你 想 要 提交 到 上 游 项 目的 分 支 





Comparing changes 


Choose two branches to see what's changed or to start a new pull request. If you need to, you can also compare across forks. 
i base: master ~ mpare: gitforteams-patch-1 ~ 
Discuss and review the changes in this comparison with others. 


1 1 0 1 


Él Commits on Apr 05, 2015 


gitforteams Update README.md 
Showing 1 changed file with 1 addition and 4 deletions. Unified | Split 
5 mamma README.md 《>》| B View — (a 


Git for Teams of One or More 


-Supporting files for workshops and sessions about creating a 











10-20: 为 了 启动 拉 取 请 求 过 程 ， 找 到 并 点 击 Create pull request 按钮 
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Open a pull request 


Create a new pull request by comparing changes across two branches. If you need to, you can also compare across forks. 


[N| ise: master v O ire: gitforteams-patch-1 ~ 
Update README.md 
Write Preview ED Markdown supported fT Edit in fullscreen 











图 10-21. 输入 标题 和 摘要 来 解释 提议 更 改 的 原因 


一 且 你 完成 了 拉 取 请 求 之 后 ， 项 目的 维护 者 将 会 在 他 们 的 GitHub 项 目 界面 上 收 到 通知 和 
邮件 提醒 (如 果 已 启用 通知 )。 


10.4 运营 你 自己 的 项 目 


在 GitHub 上 运营 一 个 项 目的 技术 部 分 非常 容易 。GitHub 为 你 提供 了 issue 队列 、 附 带 的 文 
档 页 面 (wiki), 、 通 过 拉 取 请 求 支持 外 来 代码 更 改 以 及 为 仓库 授予 写 入 权限 的 能 力 。 因 此 ， 
困难 在 于 社交 部 分 ， 如 何 创建 一 个 以 你 的 软件 项 目 为 中 心 的 消费 者 和 贡献 者 社区 。 你 应 该 
回 到 第 2 章 来 回想 起 如 何 运 营 好 一 个 项 目 。 


10.4.1 创建 项 目 仓库 

我 的 大 多 数 公 开 GitHub 仓库 都 很 小 ， 比 如 各 种 会 议 的 演示 文稿 。 我 并 不 期 望 会 有 定期 的 
贡献 者 ， 尽 管 如 果 人 们 有 兴趣 提交 一 个 新 的 修复 ， 我 会 很 高 兴 接 受 贡献 。 如 果 你 正在 制作 
一 个 软件 包 ， 其 他 人 更 有 可 能 有 兴趣 为 项 目 做 出 贡献 。 如 果 你 正在 编写 一 个 你 认为 会 帮 有 到 
更 多 人 的 库 或 软件 包 ， 则 不 应 该 将 它 放 在 你 的 私人 账户 下 ， 而 应 该 使 用 组 织 。 不 使 用 私人 
账户 可 以 让 开发 者 对 这 个 项 目 产生 更 大 的 归属 感 ， 并 专注 地 做 出 贡献 。 


要 创建 新 项 目 ， 请 完成 以 下 步骤 。 


(1) 在 顶部 菜单 中 ， 点 击 + 符 号 。 
(2) 点 击 New repository (新 建仓 库 )。 系 统 会 将 你 重 定向 到 新 建 项 目 表单 。 
(3) 在 Owner (所 有 者 ) 标签 下 ， 点 击 你 的 账户 并 将 它 更 改 为 你 的 组 织 。 
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(4) 输 入 仓库 名 称 。 一 般 来 说 这 个 名 称 应 该 与 项 目 相同 ， 如 果 组 织 中 只 有 一 个 仓库 。 

(5) 为 你 的 项 目 输入 一 段 精简 的 描述 。 

(6) 点 击 Create repository (新 建仓 库 )。 

你 的 新 仓库 已 经 创建 ， 现 在 你 可 以 开始 使 用 这 个 仓库 ， 就 好 像 这 是 你 的 一 个 私人 GitHub 
仓库 一 样 。 

如 果 项 目 已 经 存在 于 你 的 私人 账户 下 ， 你 可 以 使 用 以 下 步骤 重新 分 配 这 个 项 目 。 


(1) 前 往 你 的 个 人 账户 下 的 项 目 页 面 。 

(2) 找 到 并 点 击 Settings (设置 ) 链接 。 

G) 找到 并 点 击 Transfer. (转移 ) 按钮 。 此 时 将 出 现 一 个 模式 窗口 。 

(4) 输 入 仓库 名 称 ， 新 的 所 有 者 的 组 织 名 或 账户 名 。 

(5) 点 击 E understand, transfer this repo. (我 理解 将 会 产生 的 后 果 并 转移 仓库 )。 


你 的 项 目 将 会 被 重新 分 配 新 的 账户 。 


根据 你 的 治理 规则 ， 你 需要 决定 是 准备 使 用 拉 取 请 求 还 是 继续 将 工作 直接 提交 到 项 目 。 两 
种 方式 都 有 各 自 的 优点 ， 但 它们 也 遵循 不 同 的 领导 力 模型 (直接 提交 更 快 ， 但 如 果 你 还 要 
提交 需要 评审 的 拉 取 请 求 ， 对 所 有 贡献 者 来 说 更 加 公平 )。 


10.4.2 ”授权 共同 维护 


为 了 分 担 维护 的 重担 ， 你 可 以 将 仓库 的 写 入 权限 授权 给 他 人 。 这 是 一 个 重大 的 责任 。 你 应 
该 提前 决定 你 想 要 怎样 处 理 环 手 的 问题 ， 比 如 代码 方向 上 的 分 歧 以 及 其 他 类 型 的 不 良 行 
为 ， 比 如 对 其 他 贡献 者 不 友好 。 假 设 你 已 经 想 明白 了 这 些 复杂 的 决定 ， 则 可 以 通过 以 下 步 
又 添加 项 目的 贡献 者 。 


(1) 前 往 项 目 页 面 。 

(2) 在 页 面 右上 方 的 工具 链接 中 点 击 +， 然 后 选择 New collaborator (新 建 协作 者 ， 图 10-22)。 
(3) 系统 将 提示 你 输入 密码 ， 然 后 点 击 Continue (下 一 步 )。 

(4) 输入 你 想 要 分 配 的 共同 维护 者 的 GitHub 用 户 名 (图 10-23)。 
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图 10-22: 前 往 项 目的 协作 者 页 面 
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10-23: 在 项 目 中 添加 协作 者 

你 指定 成 为 共同 维护 者 的 成 员 现 在 拥有 与 你 相同 的 管理 权限 。 你 或 许 希 望 指定 一 个 维护 备 
忘 单 ， 确 保 你 们 的 决定 对 于 所 有 社区 成 员 来 说 是 一 致 的 。 

要 想 移 除 一 个 协作 者 ， 请 遵循 之 前 概述 的 说 明 。 在 协作 者 姓名 右边 ， 点 击 x 符 号 (图 1024), 
这 个 协作 者 将 不 再 拥有 仓库 的 提交 权限 。 





Collaborators Push access to the repository 


gitforteams 2 we 











10-24: 从 项 目 中 移 除 协 作者 


10.4.3 ”评审 并 接受 拉 取 请 求 
恭喜 你 ! 你 已 经 收 到 了 项 目的 第 一 个 拉 取 请 求 。GitHub 为 你 提供 了 一 个 易于 使 用 的 界面 来 
评审 收 到 的 拉 取 请 求 。 你 可 以 在 这 里 评审 这 个 请 求 ， 立 即 拒绝 或 接受 这 个 拉 取 请 求 。 
如 果 接 受 拉 取 请 求 会 导致 合并 冲突 ， 那 么 GitHub 会 通知 你 ， 并 且 在 这 种 情况 下 会 禁用 接 
受 传 入 请 求 的 按钮 。 
试 一 试 给 你 自己 提交 一 个 拉 取 请 求 
你 也 可 以 通过 派生 你 自己 的 工作 ， 然 后 给 自己 提交 一 个 拉 取 请 求 来 测试 这 个 
功能 。 
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10.4.4 发 生 合并 冲突 的 拉 取 请 求 
如 果 拉 取 请 求 一 定 会 导致 合并 冲突 ， 你 将 无 法 在 Web 界面 上 接受 这 个 拉 取 请 求 。 相 反 ， 你 
需要 下 载 这 个 分 支 ， 在 本 地 解决 冲突 ， 然 后 将 新 的 分 支 推送 到 项 目 仓库 。 
第 一 步 是 签 出 你 想 要 接受 这 个 拉 取 请 求 的 分 支 。 例 如 ， 你 或 许 希 望 将 它 并 入 你 的 项 目 主 分 
支 ， 如 下 所 示 。 

$ git checkout master 
目前 你 的 分 支 对 贡献 者 的 仓库 毫 无 所 知 。 在 下 载 提议 的 更 改 前 ， 你 需要 将 它 添加 为 远程 仓 
库 。 与 其 使 用 我 们 过 去 的 通用 别名 (如 origin 或 upstream) ， 不 如 乐观 些 ， 使 用 贡献 者 的 
GitHub 用 户 名 。 这 将 确保 你 准备 好 以 后 会 接受 他 们 更 多 的 更 改 。 
在 下 面 的 例子 中 ， 使 用 拉 取 请 求 的 分 支 中 合适 的 值 替 换 <username> 和 «repository-name» , 
$ git remote add username git://github.com/«username»/«repository name» 
在 添加 远程 仓库 后 ， 你 现在 必须 下 载 贡 献 者 的 工作 ， 如 下 所 示 。 

$ git fetch username 
这 个 分 支 现 在 将 被 下 载 供 本 地 评审 使 用 。 你 应 该 使 用 第 7 章 中 实行 同行 评审 的 指南 。 如 果 
代码 存在 问题 ， 你 可 能 需要 向 评审 者 提供 反馈 并 要 求 他 提交 新 的 拉 取 请 求 。 参 考 你 的 治理 
模型 来 决定 你 自己 来 更 新 是 否 合 适 ， 或 者 你 是 否 需 要 重新 打开 该 issue 以 进行 进一步 的 研 
究 。. 经 验 法 则 是 : 如 果 贡 献 者 会 从 这 个 工作 中 学 到 什么 ， 那 么 给 他 们 这 个 学 习 的 机 会 。 
如 果 这 只 是 一 个 思春 的 小 错误 〈 拼 写 错误 或 者 违反 了 代码 规范 ) ， 或 许 你 自己 修改 会 更 合 
理 一 些 (仍然 鼓励 原作 者 )， 而 不 是 因为 一 个 微小 的 修复 而 拒绝 这 个 拉 取 请 求 。 只 要 有 可 
能 ， 减 少 代码 需要 的 往返 ， 并 尊重 贡献 者 的 意图 。 
当 你 对 提议 的 更 改 感到 满意 时 ， 可 以 将 它 合 并 到 项 目的 主 分 支 ， 如 下 所 示 。 

$ git merge --no-ff username/branch name 
然而 ， 如 果 你 希望 进行 一 些 修改 来 清理 儿 个 空格 问题 ， 或 者 修复 一 个 拼写 错误 ， 你 可 以 选 
择 添 加 --no-commit 参数 。 如 果 你 决定 每 个 更 改 必 须 经 历 拉 取 请 求 环 节 ， 那 么 在 你 的 项 目 
中 使 用 这 个 选项 或 许 会 不 合适 ， 如 下 所 示 。 

$ git merge --no-ff --no-commit username/branch name 
不 管 你 使 用 什么 方法 ， 一 旦 分 支 合 并 后 ， 就 可 以 将 更 新 后 的 master 分 支 推送 到 服务 右上， 
如 下 所 示 。 

$ git push origin master 
更 改 将 会 出 现在 项 目的 主 仓库 中 。 
如 果 你 发 现 你 的 项 目 经 常 使 用 拉 取 请 求 ， 频 繁 地 需要 处 理 合并 冲突 ， 那么 Hub (https:/ 
hub.github.com/) 能 够 帮 到 你 。 这 是 一 个 命令 行 外 层 应 用 ， 人 允许 你 享受 到 在 命令 行 中 执行 
更 多 任务 的 便利 ， 而 无 需 在 GitHub 的 Web 界面 和 Git 之 间 切 换 。 
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10.5 “小 结 


在 本 章 中 ， 你 学 会 了 如 何在 单 人 团队 中 作为 其 他 项 目的 消费 者 、 贡 献 者 以 及 项 目 负 责 人 来 
使 用 GitHub。 


。 作为 仓库 的 所 有 者 ， 你 可 以 选择 直接 在 上 面 做 出 贡献 。 

。 作为 项 目的 负责 人 ， 你 可 以 选择 直接 在 项 目 中 提交 ， 或 者 通过 个 人 仓库 来 传递 你 的 贡献 
以 示 公 平 。 

。 项 目 中 的 issue 可 以 用 于 跟踪 新 功能 或 者 bug。issue 以 对 话 的 形式 出 现 ， 或许 会 因此 产 
生 一 个 拉 取 请 求 。 

。 拉 取 请 求 是 合并 外 部 仓库 中 的 分 支 或 非 主 分 支 的 请 求 。 它 可 以 由 拥有 仓库 写 入 权限 的 任 
何人 完成 。 

。 如 果 拉 取 请 求 不 会 导致 合并 冲突 ， 它 可 以 通过 网 页 界面 来 完成 ， 否 则 ， 你 将 需要 下 载 相 
关 的 分 支 ， 在 本 地 合并 请 求 并 将 结果 推送 回 主 项 目 仓库 。 

尽管 本 章 主要 讲述 公开 仓库 ， 你 同样 可 以 将 本 章 中 学 到 的 技巧 用 于 私有 仓库 。 


有 关 使 用 GitHub 的 更 多 信息 ， 你 可 以 阅读 Peter Bell 和 Brent Beer A # HY Introducing Git- 
Hub (http://shop.oreilly.com/product/0636920033059.do) 。 
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第 11 章 


Bitbucket 上 的 私有 团队 工作 








Bitbucket 是 一 个 流行 的 代码 托管 系统 ， 由 JIRA 的 开发 者 创建 。 它 有 接近 三 百 万 用 户 ， 用 
户 数量 比 GitHub 少 一 些 ， 但 对 于 小 团队 来 说 ， 它 有 两 个 很 大 的 优点 : 免费 的 私有 仓库 和 
分 支 特有 的 权限 控制 。 除 了 这 些 功 能 之 外 ， 我 认为 Bitbucket 的 界面 非常 简单 直接 ， 而 文档 
却 很 复杂 。 它 所 承诺 的 易 用 性 需要 一 段 时 间 才 能 使 内 部 团队 运转 顺利 。 

完成 本 章 学 习 之 后 ， 你 将 能 够 在 Bitbucket 上 完成 以 下 事项 。 

。 以 个 人 开发 者 的 身份 起 步 

。 与 其 他 开发 者 共享 你 的 仓库 

。 限制 给 定 项 目 分 支 特有 的 访问 控制 

本 章 不 是 全 面 的 Bitbucket 指南 ， 而 是 你 或 许 想 在 团队 中 使 用 的 一 些 重要 功能 的 概述 。 


喜欢 通过 视频 教程 学 习 的 读者 可 以 参考 本 书 附带 的 系列 视频 ，Collaborating with Git (http:// 
shop.oreilly.com/product/0636920034872.do) 。 


11.1 非 公开 项 目的 项 目 治理 


Bitbucket 仓库 与 GitHub 相 比 使 用 不 同 的 默认 选项 ， 这 带 来 了 有 趣 的 影响 。 根 据 你 的 视角 ， 
你 或 许 会 认为 它们 是 “ 谴 慎 的 ”或 “ 反 社 交 的 ”。 默 认 情 况 下 ，Bitbucket 假设 你 即将 创建 
的 仓库 是 私有 的 ， 而 这 个 仓库 的 派生 同样 也 是 私有 的 。 这 与 GitHub 的 选择 (公开 仓库 和 
公开 派生 ) 完全 相反 。 当 GitHub 使 用 了 “社交 化 编程 ”这 个 词 的 时 候 ，Bitbucket 采用 了 
一 个 非常 不 同 的 做 法 ， 但 它 不 只 是 社交 的 对 立 面 那么 简单 。 也 就 是 说 ，Bitbucket 并 不 是 反 
社交 的 。 相 反 ， 它 只 是 默认 采取 了 谨慎 的 做 法 。 

对 于 私有 仓库 和 公开 仓库 来 说 ， 尽 管 你 用 来 将 代码 从 一 处 转移 到 另 一 处 的 命令 是 相似 的 ， 
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但 是 当 人 们 收 到 邀请 参与 项 目 时 ， 给 他 们 的 政治 感觉 是 不 同 的 。 开 源 项 目 倾向 于 遵守 仓库 
整体 的 访问 控制 。 只 有 非常 少 的 维护 者 可 以 更 新 代码 的 任何 部 分 。 当 然 ， 代 码 如 何 被 项 目 
接受 的 约定 各 有 不 同 ， 但 是 一 般 来 说 ， 一 个 提交 出 现 后 ， 经 过 某 个 评审 期 ， 然 后 代码 被 项 
目的 主 仓 库 接 受 。 而 私有 仓库 倾向 于 拥有 非常 细致 的 治理 要 求 。 有 时 这 些 要 求 是 监管 机 构 
列 出 的 ， 例 如 进行 金融 交易 的 公司 必须 符合 支付 卡 产业 (PCI，Payment Card Industry) 规 
定 ， 制 造 生物 医疗 设备 的 公司 必须 遵从 某 些 规 定 。 在 某 些 情 况 下 ， 这 些 规 定 对 审计 和 接受 























代码 库 中 的 贡献 有 着 严格 的 要 求 。 














目前 ， 与 GitHub 相 比 ，Bitbucket 提供 了 更 多 更 细 粒 度 的 访问 控制 。 在 Bitbucket 上 ， 你 可 
以 阻止 个 人 、 一 群 人 推送 到 特定 的 分 支 和 整个 仓库 。 如 果 你 喜欢 使 用 Subversion 中 分 支 特 
有 的 访问 控制 ， 你 的 团队 将 会 发 现 这 个 功能 非常 有 用 。GitLab 同样 提供 了 其 中 的 一 些 功 




















能 ， 将 在 第 12 章 中 介绍 。 


11.2 开始 使 用 


在 本 节 中 ， 你 将 会 学 到 如 何在 Bitbucket 上 创建 一 个 账户 和 你 自己 的 私有 仓库 。 
开发 者 应 该 在 与 你 协作 项 目前 完成 本 节 中 所 述 的 步骤 。 


11.2.1 创建 账户 
Bitbucket 的 注册 过 程 十 分 直截了当 ， 步 又 如 下 。 
(1) 前 往 https://bitbucket.org。 








团队 中 所 有 


Q) 找到 并 点 击 标签 为 Get started. (开始 使 用 ) 的 按钮 (图 11-1)。( 可 能 有 多 个 按钮 。 任 意 


一 个 皆 可 。) 





Atlassian 


9 Bitbucket MS 


Your team, your code, 
connected 











图 11-1; 在 主页 上 找到 并 点 击 其 中 一 个 Get started 按钮 


你 可 以 选择 创建 新 账户 或 使 用 你 的 Google 账户 注册 ， 步 骤 如 下 。 
(输入 你 的 姓 和 名 。 这 两 个 字段 是 可 选 的 。 

(2) 输 入 你 喜欢 的 用 户 名 。Bitbucket 会 告诉 你 这 个 名 称 是 否 已 被 占用 。 
(3) 输 入 一 个 安全 的 密码 。 
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(4) 输入 一 个 合法 的 电子 邮件 地 址 。 
(5) 选 择 一 个 方案 。 默 认 情 况 下 ， 免 费 的 个 人 账户 方案 会 选中 ， 它 适用 于 个 人 和 非常 小 的 


团队 。 


(6) 选 中 复 选 框 ， 确 认 你 不 是 机 器 人 。 如 果 Bitbucket 认为 你 不 是 人 类 ， 那 么 你 可 


入 CAPTCHA 验证 码 。 








能 需要 输 


(7) 选 中 隐私 策略 和 客户 协议 的 复 选 框 。 显 然 ， 你 应 该 点 击 这 些 链接 并 阅读 你 即将 签署 的 


协议 。 


(8) 当 你 完成 了 所 有 字段 后 ， 点 击 Signup (注册 ) 以 继续 (图 11-2), 
(9) 你 将 会 收 到 一 封 邮 件 来 确认 你 的 电子 邮件 地 址 。 点 击 Confirm this email address. (确认 此 

















电子 邮件 地 址 )。 
Sign up Sign up with your Google account 
First name 
Last name 
Username'  gitforteams © 
Password* seeeeeeeesseeseeeeeeeseeseeeeeeoseeeessessesese e) 
Email emmaQgitforteams.com 
Plan Personal account ~ | Free 





Ny d l'm not a robot 


Accept our privacy policy and customer agreement 








图 11-2: 完成 注册 表单 中 的 每 一 个 字段 并 点 击 Sign up 
现在 ， 你 的 账户 已 经 创建 并 可 以 使 用 。 但 是 ， 为 了 节省 以 后 的 时 间 ， 你 还 应 该 添加 你 的 
SSH 密 钥 ， 这 样 以 后 每 次 使 用 私有 仓库 时 不 需要 每 次 都 验证 一 次 。 
完成 以 下 步骤 ， 将 你 的 SSH 密 钥 添加 到 你 的 账户 中 。 

() 使 用 附录 D 中 的 说 明 ， 找 到 并 复制 你 的 SSH AEH. 

(2) 前往 你 的 Bitbucket 账户 信息 中 心 。 

(3) f£ Bitbucket 网 站 的 右上 角 ， 找 到 并 点 击 用 户 图 标 。 

(4) 在 下 拉 菜 单列 表 中 ， 点 击 Manage account (管理 账户 ) 。 
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(5) 在 侧 边 导航 栏 中 ， 找 到 并 点 击 SSH keys (SSH 959), 
(6) 点 击 Add key (添加 密 钥 )。 此 时 将 会 显示 一 个 模式 窗口 。 
C) 在 表单 Key (W) 字段 中 ， 粘 贴 你 的 SSH 公 和 钥 。 

(8) 点 击 Add key, 


你 的 SSH 密 钥 已 经 添加 到 你 的 BItbucket 账户 中 。 


11.2.2 ”在 欢迎 页 面 创建 私有 项 目 


在 创建 账户 后 ，Bitbucket 将 会 立即 带 你 来 到 欢迎 页 
https://bitbucket.org/welcome 访问 。 




















& (图 11-3)。 这 


个 页 面 一 直 可 以 通过 





Create your first repository Git started 


Create your first repository 


share code with Bitbucket. 


I = 
9 g y 
Wen -— 
Tutorial Import Empty 


Enter the tutorial details 
Name' Tutorial 


This is a private repository 


No thanks 





Push up code 


Repositories hold the code for your project. You need a repository to add, edit, and 








11-3: 在 完成 注册 表单 后 ， 将 会 显示 开始 使 用 的 欢迎 页 面 


要 创建 新 仓库 ， 请 完成 以 下 步骤 。 

(D) 点 击 标注 Empty (空仓 库 ) 的 虚线 桶 状 图 标 。 

(2) 输 入 仓库 的 名 称 ， 如 johannes。 

(3) 保持 This is a private repository (这 是 一 个 私有 仓库 ) 复 选 框 选 中 。 
(4) 点 击 Create (新 建 )。 你 的 新 仓库 已 经 创建 。 

(5) 点 击 Done (完成 )。 此 时 将 会 显示 仓库 的 设置 页 面 。 
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一 旦 你 完成 了 这 些 步骤 ， 请 继续 阅读 11.2.4 市 。 


11.2.3 ”从 信息 中 心 创建 私有 项 目 


在 登录 Bitbucket 账户 后 ， 将 会 显示 一 个 项 目 摘要 信息 中 心 (图 11-4)。 在 这 个 信息 中 心中 























你 可 以 概览 你 的 每 个 项 目的 动向 ， 以 及 创建 一 个 新 仓库 。 
三 加 Bitbucket Dashboard - Teams - Repositories ~ Snippets ~ Create ~ Find a repository 
, Dashboard 
Overview Pull requests Issues Snippets 


Get started 
Bitbucket 101 Git tutorials SourceTree 
All the information you need Guides to workflows and A free Git & Mercurial client 
to get started commands, with examples. for Windows or Mac. 


Create or import a repository 


Thanks for choosing Bitbucket. Start by creating or importing a repository. 


[ol or Import an existing repository 











图 11-4: 信息 中 心 同样 给 出 了 如 何 创建 一 个 新 仓库 的 说 明 

如 果 你 是 从 信息 中 心 (这 也 是 当 你 完成 验证 后 的 首页 ) 起 步 的 ， 请 完成 以 下 指示 来 创建 新 

仓库 。 

(1) 找 到 并 点 击 Create a repository (创建 仓库 ) 按钮 。 此 时 将 会 显示 图 11-5 中 显示 的 表单 。 

(2) 输 入 仓库 名 称 ， 如 junio, 

(3) 可 选 地 ， 输 入 仓库 的 描述 。 

(4) 保持 下 列 默认 设置 不 变 。 

。 访问 层级 (如果 这 是 一 个 私有 仓库 ， 复 选 框 应 该 被 选中 ) 
。 派生 [下 拉 菜 单 应 该 被 设置 为 Allow only private forks (只 人 允许 私有 派生 )] 
。 仓库 类 型 ( 单 选 框 应 该 被 设 为 Git) 

(5) 你 可 以 选择 打开 Issue tracking (issue 跟踪 ) 或 Wiki 页 面 。 我 很 少 在 个 人 项 目 中 启用 这 
些 选 项 ， 因 为 你 只 是 想 使 用 Bitbucket 作为 一 个 代码 的 远 端 备份 ， 而 不 是 一 个 项 目 管 理 
工具 。 

(6) 最 后 ， 找 到 并 点 击 Create repository (创建 仓库 ) 。 


























Bitbucket 上 的 私有 团队 工作 | 193 





Create a new repository 





Name" 











Description 


Access level This is a private repository 
Forking Allow only private forks Y 


Repository type © Git 


Mercurial 
Project management C Issue tracking 
T) Wiki 
Language Select language... M 


Repository integrations 
HipChat O Enable HipChat notifications 


[ol Cancel 











& 11-5. 创建 新 仓库 的 表单 同样 有 一 些 共享 相关 的 设置 项 
你 的 新 仓库 已 经 创建 ， 此 时 将 会 显示 仓库 的 配置 页 面 ， 请 继续 阅读 11.2.4 市 。 


11.2.4 设置 你 的 新 仓库 


图 11-6 显示 的 是 设置 页 面 。 





加 Bitbucket Dashboard ~ Teams - Repositories ~ Snippets ~ Create ~ 





© Repository setup 

aF Your repository is empty — let's put some bits in your bucket. 

ul 

5 Get code into Bitbucket fast using Atlassian SourceTree or the command line 
v SourceTree 

v Get started using the SourceTree client 

个 

zm Download Atlassian SourceTree, a free Git and Mercurial client. Then it's just one click to clone! 

全 Clone in SourceTree 

n" 


Command line 


> I'm starting from scratch 


> Ihave an existing project 


Need a complete walkthrough? Visit Bitbucket 101 for a complete tutorial 











图 11-6: 提供 了 图 形 界面 和 命令 行 式 的 设置 指令 (新 项 目 或 现 有 项 目 ) 
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假设 你 已 经 完成 了 本 书 之 前 的 练习 ， 那 么 现在 应 该 已 经 有 了 一 个 本 地 仓库 ， 或 者 知道 如 何 
创建 一 个 ! 我 发 现在 Bitbucket 上 设置 新 项 目 时 ， 最 后 一 组 说 明 (图 11-7) 最 为 有 用 。 














v Ihave an existing project 
Already have a Git repository on your computer? Let's push it up to Bitbucket. 
cd /path/to/my/repo 
git remote add origin https://gitforteamsQbitbucket.org/gitforteams/junio.git 
git push -u origin --all £ pushes up the repo and its refs for the first time 


git push -u origin --tags # pushes up any tags 


Want to grab a repo from another site? Try our importer! 











11-7: 将 现 有 项 目 连 接 到 Bitbucket 的 设置 指令 


要 连接 你 的 本 地 仓库 和 Bitbucket 上 的 新 仓库 ， 请 完成 以 下 步骤 。 


C) 找到 并 点 击 E have an existing project. (我 已 有 项 目 ) 链接 。 一 组 附加 的 说 明 将 会 出 现在 
屏幕 上 。 

(2) 在 命令 行 中 ， 前 往 一 个 本 地 Git 仓库 。 如 果 它 已 经 连接 到 一 个 不 同 的 托管 系统 也 没 关 
系 ， 你 可 以 拥有 多 个 远程 仓库 连接 。 

G) 复制 并 粘贴 说 明 中 git 开头 的 这 些 命令 〈 例 11-1)。 


例 11-1 Bitbucket 上 的 样 例 说 明 ， 添 加 新 创建 的 仓库 为 本 地 仓库 的 远程 
如 果 该 仓库 已 经 连接 到 一 个 远程 仓库 ， 你 或 许 需要 使 用 bitbucket #4 origin, 
git remote add origin https://gitforteamsQbitbucket.org/gitforteams/junio.git 


git push -u origin --all # pushes up the repo and its refs for the first time 
git push -u origin --tags # pushes up any tags 








使 用 你 的 指令 ， 而 不 是 我 的 
不 要 复制 上 面 的 代码 片段 中 的 指令 。 复 制 Bitbucket 在 你 刚 创建 的 仓库 的 摘要 
页 面 上 提供 的 指令 。 











现在 ， 你 已 经 准备 好 作为 个 人 开发 者 在 私有 仓库 中 工作 。 你 可 以 将 你 的 代码 更 改 随时 推送 
到 Bitbucket 上 。 并 且 因 为 它 是 一 个 私有 仓库 ， 你 永远 不 需要 担心 破坏 公共 历史 ! 如 果 你 变 
基 了 一 个 分 支 ， 而 Bitbucket 拒绝 接受 这 个 分 支 的 新 版 本 ， 请 在 你 即将 输入 的 命令 后 加 上 
--force 参数 ， 如 下 所 示 。 

$ git push --force 
如 果 你 是 在 一 个 团队 中 工作 ， 那 么 更 优雅 的 写法 应 该 是 下 面 这 样 的 。 

$ git push --force-with-lease 
我 们 在 下 一 节 中 将 会 探索 Web 界面 。 同 时 ， 你 或 许 会 从 看 到 的 选项 中 发 现 一 些 价值 。 如 果 
你 在 前 几 节 中 已 经 使 用 过 GitHub 或 GitLab ， 我 相信 你 会 发 现 大 量 的 选项 都 十 分 相似 。 
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11.2.5 ”探索 你 的 项 目 


一 旦 你 的 项 目 被 推送 到 Bitbucket 后 ， 项 目 页 面 将 会 自动 从 一 组 指令 变 成 一 个 项 目 浏览 器 。 


如 果 你 的 仓库 包含 README 文件 ， 这 个 文件 将 会 显示 在 项 目 主页 上 。 





图 11-8 显示 了 我 的 





“Gi 





— 


团队 协作 ”网 站 (http:/gitforteams.com/) 的 项 目 主页 。 








三 加 Bitbucket Dashboard ~ Teams -~ Repositories ~ Snippets ~ Create ~ 
Ó Overview 出 
Last updated 36 minutes ago 1 0 
aul Language — Branch Tags 
m Access level Admin 
0 1 
$ Forks Watcher 
v 
4 9 Edit README 
EET 
& | gitforteams.com 
A Sculpin-based site containing Emma's current thinking on best practices for developer 
workflows. 
" 


Content is output into the following directories: 


* lessons => lessons -contains the activities workshop participants need to 
complete. 

* resources => resources - contains articles, offsite resources, and downloadable 
handouts. 

* posts => blog -contains updates about what's been added to the site 


New content types are defined in: app/config/sculpin kernel.yml 


Generating the Site 
Test the site locally using: 


sculpin generate —watch —server 








SSH- gitébitbucket.org:emmajane/gitfortea 


Find a repository 





E* Share o~ 


Invite users to this repo 
EE 


Recent activity 53 
1 commit 
Pushed to emmajane/gitforteams.com 
68536a3 publish.sh: updating publish scrip... 


emmajane - 37 minutes ago 


1 commit 
Pushed to emmajane/gitforteams.com 


4c79e5c README.md: removed arbitrary I... 
emmajane - 39 minutes ago 
1 commit 
Pushed to emmajane/gitforteams.com 

4d64478 README.md edited online with ... 
emmajane - an hour ago 
1 commit 
Pushed to emmajane/gitforteams.com 

392b277 README.md edited online with ... 


emmajane . 4 hours ago 





图 11-8: 项 目 主页 显示 了 你 的 站 点 状态 摘要 以 及 README 文件 的 内 容 


在 项 目 主页 上 ， 你 可 以 找到 以 下 摘要 信息 。 


。 最 近 更 新 日 期 
。 语言 (如 果 设 置 过 ) 





。 访问 层级 [将 被 设 为 Admin (管理 员 )， 如 果 这 个 仓库 是 你 的 ] 

。 分 支 [点 击 Branch. (分 支 ) 上 方 的 数字 来 查看 所 有 分 支 的 列表 ] 

。 标签 [点 击 Tags (标签 ) 上 方 的 数字 来 查看 所 有 标签 的 列表 ] 

。 派生 [点 击 Forks (派生 ) 上 方 的 数字 来 查看 所 有 公开 派生 的 列表 ] 

。 关注 者 [点击 Watcher (关注 者 ) 上 方 的 数字 来 查看 关注 仓库 的 账户 的 摘要 ] 
。 最 近 活 动 (位 于 右 侧 边栏 ， 包 括 最 近 提 交 以 及 合并 的 分 支 ) 


左 侧 边栏 有 以 下 图 标 (AATF) 


。 项 目 主页 链接 
。 快速 操作 (包括 克隆 、 创 建 分 支 和 创建 拉 取 请 求 ) 
。 概述 (与 项 目 主页 内 容 相同 ) 








。 HRD (仓库 中 所 有 文件 的 列表 ) 

。 提交 (仓库 中 所 有 的 日 志 历 史记 录 ) 
。 分 支 (只 有 在 项 目 中 推送 超过 一 个 分 支 后 才 会 出 现 ) 
。 拉 取 请 求 (与 个 人 项 目 无 关 ) 
。 FR (提供 当前 分 支 的 压缩 包 列 表 。 你 也 可 以 在 此 添加 项 目 未 跟踪 的 二 进 制 文件 ) 





。 设置 (包括 访问 详细 信息 、 
在 页 面 底部 ， 有 一 个 按钮 用 于 展开 这 些 











仓库 名 称 和 插件 ) 








侧 边栏 ， 就 可 以 通过 再 次 点 击 这 个 双 箭 头 来 折 县 它 〈 图 11-9)。 











图 标 ， 以 显示 每 个 图 标的 文本 标签 。 一 旦 你 展开 了 








emmajane 
& gitforteams.com 


ACTIONS 


1X, Clone 


l9 Create branch 


e Create pull request 


X Compare 

= Fork 
NAVIGATION 

aul Overview 

B Source 

0 Commits 

p Branches 
ct Pull requests 


€P Downloads 


$t Settings 








11-9: 展开 的 项 目 侧 边栏 


11.2.6 ”编辑 仓库 中 的 文件 


Bitbucket 允许 你 在 基于 Web 的 文本 编辑 器 中 编辑 纯 文 本 文 从 


d) 点 击 侧 边栏 中 的 Source ( 源 代码 ) 链接 。 





(D 前 往 你 希望 编辑 的 页 画 








o 











F， 步 又 如 下 所 示 。 





(3) 找 到 并 点 击 Edit (编辑 ) 按钮 。 文 本 编辑 器 将 会 出 现 (图 11-10 或 图 11-11 中 项 目 





README 文件 的 编辑 器 ) o 
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Source 


D mastr- 出 ~ gitforteams.com / source / posts / 2014-06-15-peer-review.md Source Diff History 


Editing source/ posts/2014-06-15-peer-review.md on branch: master 


title: Peer Review Process 


1 
2 
3 
4 
5 While working on a resources page for commit best practices, I 
6 ended up in [an interesting 

7 conversation] (https://twitter.com/emmajanehw/status/478280621018865664) with [Scott Murray](https://twitter.com/alignedleft) and [Camille Four 
8 


9 What a great question! How subjective! How arbitrary! How do we define "good"! 


11 I took the time to combine a few of the resources I've worked 

12 on in the last year into a single resource page, 

13 [The Review Process] (/resources/review-process.html). Right now 

14 the document builds on the documentation that I worked on with 

15 Joe Shindelar last year when I was the Project Manager at 

16  [Drupalize.Mel(http://drupalize.me). (New to PMing? You might 

17 also be interested in reading [Things I Learned From Managing 

18 My First 

19  Project](http://drupalize.me/blog/201312/things-i-learned-managing-my-first-project).) It adds some resources on dealing with additional remot 


21 The resource is far from done, especially considering it only 
22 covers one of the four models for review outlined at the 

23 beginning of the document; however, if you're looking for a 

24 starting place to begin [incorporating peer reviews into your 
25 own workflow]l(/resources/review-process.html), I think there are 
26 some valuable tips waiting for you in this new resource. 


Syntax mode: Markdown E Indentmode: Tabs B View diff Cancel 





11-10: 仓库 内 的 文本 编辑 器 





HHIIHBIBITITIEEIGOIC 0 (3) | Preview 


gitforteams.com 








A Sculpin-based site containing Emma's current thinking on 
best practices for developer workflows. 


Content is output into the following directories: 

- ' lessons! => 'lessons' - contains the activities workshop participants need to complete. 

- " resources' => 'resources' - contains articles, offsite resources, and downloadable handouts. 
- " posts' => "blog! - contains updates about what's been added to the site 

New content types are defined in: 'app/config/sculpin kernel.yml' 


* Generating the Site 


Test the site locally using: 


crulnin nonorato --wuatrceh -—-corvor 


ES -…- 


11-11: 项 目 主 页 编辑 器 











(4 在 编辑 器 底部 ， 确 认 Syntax mode (代码 高 亮 模式 )、Indent mode ( 缩 进 模式 ) 和 
Number of spaces (空格 数量 ， 并 非 所 有 文件 类 型 都 支持 ) 设置 正确 。 

(5) 编辑 文件 以 完成 必要 的 更 改 。 

(6) 找到 并 点 击 View diff. (查看 差异 ) 按钮 。 

(7) 确认 更 改 完成 且 正 确 ， 没 有 引入 多 余 的 空格 。 
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(8) 找到 并 点 击 Commit. (提交 ) 按钮 。 此 时 将 会 显示 模式 窗口 (图 11-12), 

















Commit changes 


Commit message | README.md edited online with Bitbucket| 


Create a pull request for this change 


Commit | Cancel 














11-12: 添加 说 明 描 述 你 对 项 目 主页 做 出 的 更 改 


(9) 输 入 提交 说 明 。 你 将 需要 添加 你 自己 的 格式 。 首 行 应 该 是 一 个 不 超过 80 个 字符 的 精简 
描述 。 接 下 来 的 行 可 用 于 补充 细 市 。 

(10) 找 到 并 点 击 Commit (提交 ) 按钮 。 

你 的 更 改 已 经 保存 到 Bitbucket 上 的 仓库 中 。 

将 你 的 更 改 保存 到 Bitbucket 后 ， 你 的 本 地 仓库 将 会 过 时 。 你 需要 更 新 你 的 本 地 仓库 。 由 于 

仓库 完全 是 你 自己 的 ， 你 可 以 将 更 改 拉 取 到 你 的 本 地 副本 而 不 经 审查 〈 例 11-2)。 假 设 你 

遵循 了 本 节 中 列 出 的 指令 ， 工 作 应 该 在 项 目的 主 分 支 上 完成 ， 最 有 可 能 是 在 master E. 


例 11-2 将 Bitbucket 中 的 更 改 拉 取 到 你 的 本 地 仓库 
$ git checkout master 
$ git pull --rebase 


这 些 更 改 应 该 被 干净 地 应 用 。 但 是 ， 如 果 你 遇 到 了 冲突 ， 请 参考 第 6 章 。 
你 的 本 地 仓库 已 是 最 新 。 


11.3 MARS 


你 已 经 阅读 本 书 有 些 时 间 了 。 甚 至 可 能 你 早 就 开始 了 。 因 此 ， 你 知道 我 喜欢 写 关 于 Git 的 
东西 。 我 也 知道 有 很 多 人 厌恶 写 文档 ， 而 且 觉 得 维护 起 来 都 是 痛 ， 所 以 我 知道 你 一 定 非 
常 不 情愿 。 准 备 好 了 吗 ? 我 认为 文档 是 保持 团队 关系 快乐 、 健 康 的 最 重要 的 事情 之 一 。 现 
在 ， 作 好 准备 ， 我 们 继续 。 


记录 你 的 过 程 ， 实 现 以 下 目的 。 

。 让 人 人们 更 容易 参与 到 你 的 团队 中 。 

。 设置 工作 应 该 如 何 完成 的 标准 。 

。 作为 “为 什么 特定 的 方法 和 命令 是 首选 ”这 一 讨论 的 起 点 。 

就 像 为 保龄球 馆 建立 护栏 那样 ， 优 秀 的 文档 为 你 的 项 目 建立 了 屏障 。 它 让 开发 者 几乎 不 可 
能 突然 扔 出 一 个 保龄球 ， 也 让 他 们 在 轮 到 自己 时 更 有 可 能 成 功 击 倒 所 有 球 瓶 。 尽 管 团队 中 















































Bitbucket 上 的 私有 团队 工作 | 199 








最 有 经 验 的 人 可 能 会 对 某 件 事情 应 该 如 何 完成 有 最 多 意见 ， 他 们 可 能 没有 写 下 最 佳 的 说 
明 。 让 团队 负责 人 和 一 个 新 手 开发 者 一 起 完成 这 个 文档 。 然 后 确保 整个 软件 可 以 持续 地 遵 
循 这 份 文档 而 不 需要 外 部 支持 。 

让 人 们 养 成 持续 的 习惯 会 使 人 在 面临 高 压 时 不 会 遗漏 步骤 。 这 份 文 档 还 应 该 包括 开发 者 
需要 用 来 克隆 仓库 和 提交 拉 取 请 求 的 命令 。 一 旦 你 看 到 文档 对 于 日 常任 务 多 么 有 用 ， 你 
或 许 会 开始 审视 是 否 可 以 主动 使 用 文档 的 其 他 流程 [应急 响应 方案 (https://drupalize.me/ 
blog/201501/being-prepared-when-everything-goes-wrong)， 有 人 赞同 吗 ?]。 


除了 这 些 你 已 经 习惯 编写 的 良好 提交 说 明 外 ，Bitbucket 还 提供 了 两 个 工具 来 帮助 你 记录 工 
作 : Wiki 页 面 和 issue。 在 本 市 剩余 部 分 ， 你 将 会 学 到 如 何 使 用 这 两 个 工具 。 


11.8.1 ” Wiki 页 面 中 的 项 目 文档 


要 想 开 始 与 他 人 协作 ， 最 简单 的 方式 是 将 仓库 访问 权限 授权 给 另 一 个 Bitbucket 账户。 不 
过 稍 等 一 下 ! 在 你 开始 与 某 个 新 开发 者 之 间 的 新 关系 时 ， 应 该 花 些 时 间 记 录 你 希望 怎 
样 工 作 。 这 些 步 又 应 该 记录 在 文档 中 ， 并 且 它 们 应 该 是 你 希望 使 用 的 步 又 。 幸 运 的 是 ， 
Bitbucket 上 的 Wiki 页 面 十 分 易于 编辑 ， 因 此 你 应 该 考虑 将 文档 作为 起 点 ， 而 不 是 终点 。 


要 为 你 的 项 目 启用 Wiki 页 面 ， 请 执行 以 下 操作 。 


(1) 找 到 并 点 击 项 目 中 的 设置 齿轮 。 
(2) 找 到 并 点 击 Wiki 设置 链接 。 
(3) 将 设置 从 No wiki (无 Wiki) 改 为 Private wiki (私有 Wiki) (图 11-13)。 















































Q Settings 


GENERAL 


Wiki settings 
aul Repository details 
Create and edit a wiki from a web browser. Bitbucket wikis are 
G Access management DVCS repositories. You can clone the pages and edit them on your 
local system. For a private wiki, a user's access to the code 
$ repository also applies to the wiki. For a public wiki, anyone can 
Y Username aliases view it even if the code repository is private. 


Branch management 


Deployment keys 


e Transfer repository No wiki 
c Delete repository © Private wiki 
Visible only to people with repository access 
INTEGRATIONS Public wiki 
"n HipChat integration Anyone can view, edit, and create pages 
tans E 
Links 
ISSUES 


Issue tracker settings 


WIKI 


Wiki settings 











11-13: 为 你 的 项 目 启 用 私有 Wiki 页 面 
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(4) 找到 并 点 击 Save. (保存 )。 





"i 











现在 已 经 为 你 的 项 目 启 用 了 Wiki 页 面 。 在 侧 边 栏 上 将 会 显示 一 个 新 的 图 标 ( 


11-14), 





NAVIGATION 
Overview 
Source 
Commits 
Branches 
Pull requests 


Wiki 


6C D *vowtSms 


Downloads 








图 11-14: 出 现在 项 目 侧 边栏 的 Wiki 图 标 





在 Bitbucket FP, Wiki Di Ifi 
欢迎 页 面 
后 ， 将 会 显示 项 目 所 有 Wiki 页 面 




















的 列表 。 








同样 也 是 可 以 下 载 并 在 本 地 编辑 的 仓库 。 文 档 出 现在 你 的 Wiki 
(图 11-15) 上 。 在 每 个 Wiki 页 面 的 顶部 有 一 个 面包 届 导 航 。 点 击 项 目 名 


PRZ 





© 











Wiki 出 Clone wiki + Create page 
gitforteams.com / Home View History Edit 
aul 
日 Welcome 
ò Welcome to your wiki! This is the default page we've installed for your convenience. Go ahead and edit it. 
v Wiki features 
4- This wiki uses the Markdown syntax. 
e» 
The wiki itself is actually a git repository, which means you can clone it, edit it locally/offline, add images or any other file type, and push it back to us. 
D It will be live immediately. 
-— Go ahead and try: 
$ git clone https: //emmajanegbitbucket.org/emmajane/gitforteams.com.git/wiki 
2" Wiki pages are normal files, with the .md extension. You can edit them locally, as well as creating new ones. 
Syntax highlighting 
You can also highlight snippets of text (we use the excellent Pygments library). 
" mn "3 
图 11-15; Bitbucket Wiki 的 默认 页 面 


Wiki 页 面 的 编辑 器 是 Markdown 文件 常见 的 工具 栏 ( 





图 11-16), 
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Wiki 


gitforteams.com / Home View History Edit 


Title" 


Conten | m mimeB I i I| @® Markdown- Preview 


日 


# Welcome 

Welcome to your wiki! This is the default page we've installed for your convenience. Go ahead and edit it. 
## Wiki features 

This wiki uses the [Markdown] (http://daringfireball.net/projects/markdown/) syntax. 

The wiki itself is actually a git repository, which means you can clone it, edit it locally/offline, add 
images or any other file type, and push it back to us. It will be live immediately 

Go ahead and try: 


$ git clone https://emmajanegbitbucket.org/emmajane/gitforteams.com.git/wiki 


Wiki pages are normal files, with the .md extension. You can edit them locally, as well as creating new ones 
## Guntav hinhlinhtina 


Commit message 


| save | mE 


图 11-16; Wiki 页 面 上 的 Markdown 编辑 器 











你 至 少 应 该 为 项 目 记 录 以 下 事项 。 


。 分 支 约定 

。 向 项 目 提交 新 工作 的 分 步 说 明 

。 同行 评审 的 分 步 说 明 

。 部 署 说 明 ， 包 括 向 谁 发 邮件 以 及 邮件 的 复制 粘贴 模板 

只 要 你 认为 人 们 有 可 能 会 出 现 不 同 的 看 法 ， 或 者 有 可 能 会 忘记 某 一 步 ， 你 都 应 该 在 文档 中 
记录 。 它 不 需要 很 长 ， 但 必须 是 正确 的 ， 定 期 查看 你 的 团队 是 否 喜 欢 采 取 别 的 流程 。 有 可 
能 团队 找到 了 一 种 没有 记录 在 文档 中 ， 但 更 有 效 的 方式 。 


11.3.2 ”使 用 issue 跟 踪 你 的 更 改 


issue 跟踪 是 另 一 种 形式 的 文档 。 尽 管 与 Wiki 页 面相 比 ，issue 存在 时 间 更 短 ， 在 一 个 工 单 
中 记录 信息 直接 地 提供 了 代码 开发 任务 的 商业 价值 ， 或 功能 构建 的 原因 。 


要 启用 issue 跟踪 工具 ， 请 完成 以 下 步骤 。 


(1) 前 往 你 的 项 目 仓库 。 

(2) 找到 并 点 击 Settings (设置 ) 图 标 。 

(3) 找到 并 点 击 Issue tracker settings. (issue 跟踪 工具 设置 )。 

(4) 将 表单 选项 从 No issue tracker. (无 issue 跟踪 工具 ) A Private issue tracker. (私有 issue 
跟踪 工具 )。 






































E 


202 | 第 11 章 


(5) 可 以 选择 输入 一 个 新 的 issue 消息 。 

(6) 找到 并 点 击 Save (保存 ) 按钮 。 

如 你 在 图 11-17 中 所 见 ， 我 在 New issue message (r£ issue 消息 ) 字段 中 为 所 有 新 issue 
提供 了 一 条 默认 消息 。 














© settings 
S Issue tracker settings ES 
uil Repository details V 
Track your project's feature requests, bug reports, and h 
Ø Access management other project management tasks. For a private tracker, a 
z user's access to the code repository also applies to the JIRA is the project tracker for teams planning, 
Branch management 
$ tracker. For a public tracker, anyone can building and launching great products. 
Username aliases kiss ied on issues even if the code Learn more about JIRA 
repository is private. 
v Deployment keys ON OY Nr TV 
eb Transfer repository Issue tracker © No issue tracker 
[ib] Delete repository © Private issue tracker 
Visible only to people with repository access 
e INTEGRATIONS 
Public issue tracker 
HipChat integration Anyone can view, create, and comment on issues 
fe] Hooks 
New issue message || m|mw|mw|B|7 | E020 @ Preview 
Links 
# Card # 
ISSUES 
" Asa (actor) | 
Issue tracker settings Iwantto (action) - 
so I can (business value for adding this feature) - 
WIKI 
Wiki settings # Conversation # 
# Confirmation # 
This is displayed to users when creating an issue. Use this message to help guide issue creation 











图 11-17: 启用 issue 跟踪 工具 ， 并 且 为 新 issue 添加 默认 消息 


这 条 消息 提醒 人 们 遵循 敏捷 开发 的 约定 ， 即 卡片 (Card)、 讨 论 (Conversion) 和 确认 
(Confirmation)。 文 字 将 会 出 现在 新 建 issue 表单 中 。 你 的 团队 或 许 有 另 一 组 想 要 遵循 的 格 
式 。 我 曾经 使 用 过 并 且 非 常 喜欢 的 另 一 种 格式 用 的 是 这 样 的 标题 : QA 测试 、 原 因 和 详细 


信 息 o 


创建 优秀 issue 

确保 卡片 清晰 地 定义 了 谁 将 以 何 种 方式 受益 于 即将 构建 的 功能 。 换 句 话说 : 
商业 价值 是 什么 ?这 将 允许 进行 这 个 任务 的 人 询问 利益 干系 人 关于 细节 实现 
的 问题 。 理 解 issue 在 更 大 的 项 目 上 下 文中 的 作用 将 会 保证 整个 项 目 使 用 了 
正确 搭建 的 脚手架 ， 而 不 是 胶带 。 
并 非 所 有 issue 都 是 作为 新 功能 开始 的 。 偶 尔 bug 会 潜入 你 的 软件 。 优 秀 的 
bug 报告 应 该 包括 : 复 现 问题 的 步骤 、 期 望 的 结果 和 上 述 步骤 产生 的 实际 结 
果 ， 包 含 一 张 屏幕 截图 或 者 结果 的 视频 。 
关于 创建 优秀 issue 的 信息 可 以 在 创建 工 单 与 报告 issue (http://gitforteams. 


com/resources/great-issues.html) 中 了 解 。 
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现在 已 经 在 你 的 项 目 中 启用 了 issue 跟踪 (图 11-18). 














NAVIGATION 
Overview 
Source 
Commits 
Branches 
Pull requests 
Issues 

Wiki 


Downloads 


Settings 








& 6c [5b NV ouE 





11-18: Issues 图 标 现在 出 现在 项 目 侧 边栏 中 


要 创建 新 issue， 请 完成 以 下 步骤 。 


(1) 在 项 目 侧 边 栏 中 ， 找 到 并 点 击 Issues 图 标 。 

(D 如 果 这 是 你 第 一 次 使 用 issue 跟踪 工具 ， 那 么 将 会 显示 一 个 欢迎 页 面 ， 点 击 Create your 
first issue (创建 第 一 个 issue) 以 继续 。 如 果 这 不 是 你 的 第 一 次 ， 那 么 将 会 显示 所 有 
issue 的 摘要 页 面 。 在 这 个 页 面 中 ， 找 到 并 点 击 Create Issue. (创建 issue) 按钮 。 此 时 将 
会 显示 一 个 issue 创建 表单 。 

(3) 在 新 issue 创建 表单 中 (图 11-19)， 为 你 的 issue 添加 一 个 标题 和 描述 。Assignee (接受 
者 )、Kind (类 型 ) 和 Priority (优先 级 ) 的 默认 值 或 许 足够 。 












































© Issues + Create issue 


Create issue 





Card 
8 As a (actor) | want to (action) so | can (business value for adding this feature) 
: [o] 
v Conversation 
出 
9 Confirmation 

Tite" [el 

e 

Description || m/m m | B | I | iz Iz | 9) 四 (Q Preview 
x 


Assignee | Select user 
Assign to me 
Kind' bug 
Priority major 


Attachments | Select files 











11-19; 新 issue 创建 表单 
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(4) 当 你 尽 己 所 能 描述 新 issue 后 ， 点 击 Create issue 按钮 。 

你 的 issue 已 经 创建 (图 11-20) 并 可 从 项 目 侧 边栏 的 Issues 图 标 访问 ， 你 现在 可 以 等 待 有 
人 开始 解决 这 个 issue。 不 过 ， 首 先 你 需要 授权 他 们 可 以 访问 项 目 ， 这 样 就 不 需要 自己 解决 
每 个 工 单 。 























Ó Issues + Create issue 
Issue #1 CEJ Workflow ~ More ~ Edit 
„ul | Confirm instructions 
á - Assignee - 
8 图 emmajane | REPO OWNER | created an issue 55 seconds ago a fib 
ype l® bug 
Card 
$ Priority 个 major 
As an author, | want to provide detailed instructions so that you can use Git more efficiently. Status new 
v Votes ^0. Vote for this issue 
eh Conversation Watchers @ Stop watching 
Cj * Itreally is important to test these instructions hard. Errors are easy to fix now, but 
much more embarrassing to fix later. 
D Need more out of your 
issue tracker? Quo 
nd Confirmation Learn more about JIRA x JIRA 
As a proof reader: confirm the instructions in the book are correct. Report back any mistakes 
zt you find so that the author can fix them. 
Comments (0) 





D 
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11.4 ”访问 控制 


尽管 没有 统计 数据 表明 这 是 使 用 Bitbucket 最 流行 的 方式 ， 但 我 看 到 的 团队 中 最 常见 的 做 
法 是 保留 默认 值 ， 私 有 仓库 ， 且 允许 私有 派生 。 对 于 小 团队 来 说 ， 我 最 常 看 到 的 工作 流 是 
F 发 者 创建 他 们 自己 的 派生 ， 从 他 们 自己 的 仓库 中 提交 拉 取 请 求 (图 11-21)。 然 而 ， 只 有 
一 两 个 人 的 团队 通常 省 略为 团队 中 每 个 人 创建 单独 仓库 这 一 步 ， 而 是 直接 在 主 仓库 中 协作 
(图 11-22)。 


每 个 开发 者 拥有 一 个 单独 的 仓库 并 没有 禁止 人 们 向 主 项 目 仓库 做 出 贡献 ， 如 果 你 正在 实施 
同行 评审 ， 事实 上 正如 你 所 愿 : 每 个 开发 者 都 可 以 向 主 项 目 仓库 进行 提交 ， 但 约定 只 限制 
他 们 在 经 过 评审 前 不 能 提交 自己 的 工作 。 然 而 ， 如 果 你 正在 与 质量 保证 团队 合作 ， 则 会 希 
望 进行 限制 ， 只 有 QA 团队 有 主 项 目 仓库 的 写 入 权限 。 在 这 种 情况 下 ， 每 个 开发 者 需要 创 
建 一 份 项 目的 派生 才能 提交 他 们 的 工作 。 
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THERE 个 人 仓库 





通过 Web 页 面 提交 


克隆 


推送 














图 11-21: 多 人 团队 通常 使 用 Bitbucket 上 的 一 个 中 间 仓 库 





Bitbucket 


项 目 仓库 









取 请 求 


克隆 推送 




















图 11-22: 只 有 一 两 个 人 的 团队 通常 直接 在 共享 仓库 中 工作 





206 | 第 11 章 


11.4.1 共享 权限 


如 果 你 的 团队 中 都 是 十 分 可 信和 的 开发 者 ， 你 可 以 选择 让 他 们 提交 到 同一 个 仓库 

个 分 支 的 用 途 。 

要 授权 开发 者 访问 你 的 仓库 ， 请 完成 以 下 步骤 。 

(1) 前 往 Settings (设置 ) 一 Access management. (访问 管理 ) 。 

(2) 在 标签 为 Users. (用 户 ) 的 字段 中 添加 你 想 要 添加 的 开发 者 的 Bitbucket 用 户 名 或 电子 邮 
件 地 址 。 

(3) 将 访问 层级 从 read. (只 读 ) 改 为 write ( 读 写 )。 

(4) 点击 Add. (添加 )。 


为 你 想 要 将 仓库 与 之 共享 的 每 个 开发 者 重复 这 些 步 又 。 开 发 者 将 能 够 做 到 除了 项 目 管理 之 
外 的 所 有 事情 。 你 已 经 准备 好 了 文档 ， 对 吧 ? 因为 现在 唯一 维系 这 个 项 目的 事情 就 是 你 文 
档 中 记录 并 自己 同意 严格 遵守 的 社区 约定 。 


11.4.2 每 个 开发 者 分 别 派生 项 目 


随 着 你 的 团队 增长 ， 你 可 能 希望 避免 某 些 团队 可 以 直接 拥有 仓库 的 写 人 权限 。 或 许 你 希望 
仅 QA 团队 可 以 写 入 主 仓库 。 在 这 种 情况 下 ， 开 发 者 需要 创建 一 个 项 目的 派生 ， 并 通过 拉 
取 请 求 提 交 他 们 的 工作 。 


要 创建 项 目的 派生 ， 请 完成 以 下 步骤 。 


(D 找到 并 点 击 项 目 侧 边栏 上 的 Actions (操作 ) 图 标 ， 即 图 标 下 方 的 三 个 点 。 

(2) 点 击 标签 为 Fork (派生 ) 的 链接 。 

(3) 此 时 将 会 显示 项 目 创 建 页 面 ， 与 你 第 一 次 创建 自己 的 Bitbucket 仓库 时 所 见 到 的 十 分 类 
似 。 在 这 个 表单 中 ， 你 可 以 保持 所 有 默认 值 不 变 。 

(4) 你 可 以 禁用 Wiki 和 Issues 选项 。 你 应 该 在 主 项 目 仓库 中 跟踪 这 些 信息 。 

(5) 为 了 完成 这 个 流程 ， 点 击 Fork repository (派生 仓库 )。 

现在 ， 你 可 以 创建 一 份 本 地 克隆 并 开始 你 的 工作 ， 步 又 如 下 。 

CD 点 击 项 目 侧 边栏 上 的 Actions (操作 ) 图 标 。 

(2) 选择 Clone (克隆 )。 此 时 将 会 显示 一 个 模式 窗口 。 

(3) 在 模式 窗口 中 ， 选 择 并 复制 命令 行 指令 。 

(4) 在 命令 行 中 ， 前 往 你 想 要 放置 克隆 的 仓库 副本 的 目录 。 

(5) 粘贴 Bitbucket 提供 的 命令 。 这 个 仓库 将 会 开始 下 载 。 

一 旦 仓库 下 载 完 成 后 ， 你 可 以 创建 一 个 新 的 分 支 并 开始 解决 你 的 工 单 。 


11.4.3 ”通过 保护 分 支 限 制 访问 

如 果 你 之 前 使 用 过 Subversion， 那 么 在 转 到 Git 并 发 现 它 几 乎 没有 访问 控制 时 ， 可 能 会 感到 
很 惊讶 。 尤 其 是 内 置 这 个 功能 。Git 内 置 了 让 你 通过 钩子 构建 访问 控制 的 能 力 。 这 些 钩子 允 
许 你 在 提交 发 生前 后 或 者 推送 到 远程 仓库 前 后 使 用 脚本 来 编写 回应 。 如 果 你 自己 托管 Git 仓 


并 约定 每 
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E, BATUZ EAE, [ER Uno ot T RH ACRES ZR dE. M RERIT 
这 个 功能 。( 甚 至 即使 你 听 说 过 ， 假 如 正在 学 习 Git 的 基础 ， 也 不 会 想到 去 编写 钩子 。) 


3EJGHJAE, Bitbucket 帮 你 完成 了 这 些 工作 。 你 可 以 在 Web 界面 上 授权 每 个 人 或 每 个 团队 
的 写 和 权限。 在 第 2 章 和 第 3 章 中 ， 你 和 团队 一 起 制定 了 治理 策略 ， 或 许 还 有 分 支 策略 。 
我 不 会 再 次 介绍 这 些 。 如 果 你 不 确定 你 应 该 如 何 利 用 这 些 访问 控制 选项 ， 应 该 回去 复习 这 


Ibit 


eB, 














你 之 前 学 到 了 如 何 授权 访问 整个 仓库 。 在 本 节 中 ， 你 将 会 学 到 如 何 授权 每 个 分 支 的 访问 。 

在 继续 本 节 之 前 ， 确 保 你 已 经 授予 想 要 一 起 协作 的 开发 者 访问 仓库 的 权限 。 

要 限制 分 支 访问 ， 请 完成 以 下 步骤 。 

(1) 前 往 Settings (设置 ) 一 Branch management (分 支管 理 ) 。 

(2) 在 标题 limit pushes to specific users and groups (限制 特定 用 户 和 群 组 的 推送 ) 下 的 第 一 
个 字段 中 ， 输 入 你 想 要 限制 访问 的 分 支 名 称 ; 在 第 二 个 字段 中 ， 输 入 你 允许 更 新 该 分 支 
中 文件 的 成 员 名 称 。 

(3) 点击 Add (添加 ) 按钮 。 

除了 列 出 的 成 员外 ， 其 他 成 员 都 被 限制 了 将 代码 推送 到 该 分 支 的 权限 。 图 11-23 显示 ， 一 

旦 你 添加 某 个 成 员 之 后 ， 就 可 以 继续 添加 下 一 个 。 


























Limit pushes to specific users and groups 


Start typing to search for a user or group 
master 园 emmajane Edit @ 


Remaining branches accept pushes from any user or group with write access. 











图 11-23: 阻止 其 他 人 将 代码 推送 到 某 个 分 支 

















在 同一 个 设置 页 面 ，Bitbucket 同样 提供 了 阻止 删除 任何 分 支 的 选项 。 尽 管 当 你 的 团队 在 指 
导 如 何 安 全 地 使 用 Git 工作 时 ， 这 两 个 选项 没有 那么 吸引 人 ， 但 你 的 “朋友 ”可 能 仍然 需 
要 它 。[ 没 关系 ， 我 理解 ，Atlassian (https://www.atlassian.com/) 也 是 ， 这 也 是 为 什么 它 为 


你 提供 了 这 两 个 功能 。] 


一 旦 设置 完成 后 ， 如 果 有 人 试图 执行 一 个 受 限 的 操作 ， 则 会 返回 到 一 个 错误 页 面 。 例 11-3 
展示 了 一 个 例子 ， 当 我 尝试 删除 一 个 名 为 master 的 受 保护 分 支 时 会 发 生 什 么 。 


例 11-3 在 删除 锁定 分 支 时 的 错误 
$ git push bitbucket master --delete 
remote: permission denied to delete branch master 
To gitQbitbucket.org:emmajane/gitforteams.git 
! [remote rejected] locked (pre-receive hook declined) 
error: failed to push some refs to 'git(übitbucket.org:emmajane/gitforteams.git' 


如 果 你 决定 使 用 访问 控制 ， 确 保 你 已 清楚 地 与 你 的 团队 沟通 过 这 些 限制 。 在 开发 者 弄 不 明 
白 他 们 为 什么 无 法 将 代码 推送 到 项 目 仓库 时 ， 这 将 帮助 他 们 避免 陷入 必然 的 诅 丧 。 你 不 需 
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要 提供 设 人 会 看 的 长 篇 大 论 ， 但 确实 需要 告诉 他 们 做 出 这 些 决 定 的 原因 ， 以 及 让 你 的 系统 
成 为 独一无二 的 雪花 状 架 构 的 技巧 。 

更 多 关于 分 支管 理 (https://confluence.atlassian.com/display/BITBUCKET/Branch+management) 
的 信息 可 以 在 Bitbucket 上 找到 。 你 可 能 还 对 Atlassian 的 Git #9 F (https://bitly.com/gits- 
hooks/) 使 用 概述 感 兴 


11.5 拉 取 请 求 

你 的 开发 者 要 想 将 工作 添加 回 仓 库 ， 他 们 需要 权限 。 如 果 没 有 权限 〈 要 么 按照 社区 约定 完 
成 同行 评审 ， 要 么 通过 强制 的 访问 控制 )， 开 发 者 需要 创建 一 个 拉 取 请 求 来 考虑 将 他 们 的 
工作 添加 到 主 项 目 中 。 

Atlassian 的 Bitbucket 官方 文档 写 得 非常 好 。 使 用 拉 取 请 求 (https://confluence.atlassian.com/ 
bitbucket/work-with-pull-requests-223220593.html) 介绍 了 一 些 额外 的 功能 ， 并 会 一 直 保 持 最 
新 (如 果 本 节 中 使 用 的 指令 已 过 时 )。 


11.5.1 提交 拉 取 请 求 

在 你 的 工 单 分 支 中 完成 issue 相关 的 工作 ， 并 将 代码 推送 至 服务 器 之 后 ， 你 可 以 发 起 一 个 
拉 取 请 求 来 将 你 的 工作 整合 到 主 项 目 仓 库 。 这 个 界面 选项 会 根据 你 选择 的 访问 控制 方法 不 
同 而 略 有 差异 。 不 过 ， 基 本 流程 如 下 所 示 。 

(1) 找 到 并 点 击 侧 边栏 上 的 Pull requests ( 拉 取 请 求 ) 图 标 。 

(2) 找到 并 点 击 Create pull request. (创建 拉 取 请 求 ) 链接 。 针 对 你 的 请 求 的 一 个 新 表单 将 会 
出 现 (图 11-24), 












































© Pull requests 


Create a pull request 


aul 
emmajane / gitforteams.com fork 
目 at ue a : emmajane/gitforteams.com 
Created 23 hours ago, updated 23 hours ago 
9 v master X v master 
而 Tit 
口 Description ^w ipm B I iE O 四 (9) Preview 
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Reviewers Start typing to search for a user 











图 11-24: 拉 取 请 求 新 建 表 单 
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(3) 你 的 当前 仓库 位 于 左 侧 。 在 选项 中 ， 选 择 包含 你 想 要 并 入 主 项 目的 更 改 的 分 支 。 

(4) 目标 分 支 位 于 右 侧 。 如 果 你 的 仓库 是 派生 的 ， 你 可 以 选择 目标 仓库 和 目标 分 支 。 

(5) 为 你 的 拉 取 请 求 添加 标题 和 描述 。 理 想 情况 下 ， 你 的 描述 应 该 引用 你 打算 关闭 的 issue, 

(6) 如 果 你 希望 某 人 评审 你 的 工作 ， 可 以 在 拉 取 请 求 中 输入 他 的 名 字 。 

(T) 你 可 以 选择 让 Bitbucket 赫 你 进行 一 些 维护 ， 在 拉 取 请 求 被 接受 且 工 单 被 关闭 后 ， 删 除 
IÓ x, 

(8) 最 后 ， 当 表单 完成 后 ， 点 击 Create pull request 按钮 。 


作为 开发 者 ， 你 现在 必须 等 到 你 的 工作 被 评审 并 接受 后 进入 项 目 ， 或 者 被 要 求 更 新 你 的 
请 求 。 


11.5.2 ”接受 拉 取 请 求 
一 旦 拉 取 请 求 提 交 后 ， 评 审 者 会 决定 提议 的 更 改 是 否 值得 加 入 主 分 支 。 第 8 章 详细 介绍 了 
评审 环节 。 拉 取 请 求 的 摘要 页 面 允 许 评审 者 评论 被 提议 的 工作 。 讨 论 可 能 会 导致 拉 取 请 求 
更 新 ， 或 确认 工作 已 经 正确 地 完成 并 可 以 并 入 项 目 。 
假设 没有 冲突 ， 你 可 以 通过 点 击 请 求 中 的 Merge (合并 ) 按钮 来 接受 拉 取 请 求 。 
然而 ， 如 果 存 在 合并 冲突 ， 这 个 过 程 会 更 复杂 一 些 。 通 常 ， 解 决 冲 突 的 最 佳人 选 是 添加 的 
新 代码 的 开发 者 。 通 常 代 码 在 等 待 评审 时 会 变 得 过 时 。 让 开发 者 更 新 她 的 工 单 分 支 ， 使 分 
支 包含 父 分 支 ( 或 源 分 支 ) 中 最 新 的 更 改 ， 如 下 所 示 。 

$ git pull --rebase-preserve 
如 果 提 交 这 个 拉 取 请 求 的 开发 者 无 法 解决 合并 冲突 ， 你 可 能 需要 自己 完成 这 一 步 。 幸 运 的 
是 ，Bitbucket 为 你 提供 了 可 以 复制 粘贴 的 命令 来 下 载 工 单 分 支 并 解决 冲突 。 


11.6 使 用 Atlassian Connect 扩 展 Bitbucket 


除了 Bitbucket 自 带 的 这 些 功 能 之 外 ， 插 件 API Atlassian Connect 提供 了 一 个 免费 和 付费 插 

件 的 市 场 。 

要 找到 与 你 项 目 相关 的 插件 ， 请 完成 以 下 步骤 。 

(1) 点 击 页 面 右 上 角 的 用 户 图 标 ， 前 往 你 的 项 目 管理 页 面 ， 然 后 选择 Manage account. (管理 
账户 )。 

(2) 从 你 的 账户 的 左边 栏 中 ， 找 到 并 点 击 Find new add-ons (寻找 新 插件 )。 所 有 插件 的 列表 
将 会 出 现在 主要 区 域 中 (图 11-25)。 
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OBitbucket Dashboard ~ Teams - Repositories ~ Snippets - ^ Create ~ 


Find a repository. 





Manage D emmajane ~ 


eM Find new add-ons 
Account settings 

Email addresses All categories ~ 
Notifications 


Change username Aerobatic Hosting 
By Aerobat 
Dolto SOCO DEPLOYMENT ) PREVIEW 


PLANS AND BILLING 


Install 


Host and manage your web app directly from your Bitbucket repo. 


Plan details Awesome Graphs for Bitbucket Install 
€^; 
Y By StiltSoft 

ACCESS MANAGEMENT Ww CODE ANALYTICS | | PREVIEW 
User groups Awesome Graphs adds graphs which let you visualise information about your repository, 
OAuth commits and committers. 
SECURITY Bitbucket for HipChat Install 
Change password COLLABORATION 
SSH keys Let your codebase join the conversation. Get notifications from your Bitbucket for commit 
Connected accounts pushes, pull requests, pull request merges, and issues. 
Sessions bitHound Install 
Audit log By bitHi 

CODE QUALITY | ( PREVIEW 
ADD-ONS 


Build resilient, remarkable software. 
Find new add-ons dii 77 


CloudCannon 
Manage add-ons 


By CloudCann 
DEPLOYMENT | [ PREVIEW 





Install 








图 11-25; 通过 Atlassian Connect 可 得 到 的 可 用 插件 列表 


你 可 以 通过 类 别 过 滤 这 个 列表 。 例 如 : 代码 分 析 


、 代 码 质量 、 协 作 和 部 署 。 这 是 一 个 新 的 


服务 ， 因 此 当 你 阅读 本 书 的 时 候 ， 应 该 已 经 有 很 多 可 供 浏 览 的 插件 了 。 下 面 是 一 些 值 得 研 


究 的 插件 。 
e bitHound (https:/www.bithound.io/) 


根据 代码 指令 、 可 维护 性 和 稳定 性 给 你 的 JavaScript 项 目 评 分 。 对 闭 源 项 目 收费 ， 对 开 


源 项 目 免 费 。 


e Aerobatic Hosting (https://www.aerobatic.com/) 


允许 你 部 署 静态 网 站 ， 类 似 GitHub Pages， 除 了 它 是 从 私有 的 Bitbucket © Perf 81d 


之 外。 





的 


[on 


e Pull Request Auto Reviewers (https://marketplace.atlassian.com/plugins/com.atlassian.labs. 


pr-auto- reviewer/versions) 


允许 你 自动 为 特定 类 型 的 拉 取 请 求 分 配 评审 者 。 


除了 Connect 的 插件 外 ， 你 还 可 以 从 自 定义 URL 安装 插件 。 你 可 以 在 Atlassian 的 开发 者 
门户 中 学 到 更 多 关于 开发 Connect (https://developer.atlassian.com/static/bitbucket/) 的 信息 。 


有 可 能 你 的 插件 不 仅 对 你 的 团队 有 用 ， 也 对 其 他 











团队 有 用 。 在 你 构建 它 的 时 候 ， 考 虑 程序 


的 抽象 性 ， 从 而 可 以 在 市 场 上 共享 给 (或 卖 给 ) 其 他 人 。 
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11.7 4% 


在 本 章 中 ， 你 学 到 了 如 何 使 用 Atlassian 的 流行 代码 托管 平台 Bitbucket。 你 学 到 了 如 何 设 置 

一 个 个 人 项 目 ， 并 将 你 的 仓库 共享 给 别人 。 为 了 顺利 地 在 私有 项 目 中 协作 ， 你 需要 牢记 在 

本 章 中 学 到 的 以 下 几 项 内 容 。 

。 通过 首先 创建 一 个 个 人 的 私有 仓库 来 熟悉 你 的 工具 。 

。 通过 创建 可 以 很 容易 从 项 目 仓库 访问 的 优秀 上 和 手 文档 ， 迎 接 团 队 新 成 员 的 加 入 。 

。 在 仓库 中 使 用 基于 issue 的 更 新 ， 描 述 在 仓库 中 创建 新 分 支 之 前 在 issue 中 所 有 提议 的 

更 改 。 

。 让 关于 访问 控制 的 决定 清晰 透明 。 如 果 你 限制 了 访问 ， 请 在 文档 中 记录 你 作出 这 个 决定 
的 原因 。 

多 年 来 我 一 直 对 Atlassian 这 家 公司 有 很 深 的 印象 。 它 不 断 地 提供 易于 理解 、 组 织 良好 的 文 

档 和 乐于 助人 的 员工 。 偶 尔 出 现 问题 时 ， 它 也 以 一 种 成 熟 的 、 令 人 尊敬 的 方式 承担 起 了 责 


任 。 干 得 漂亮 ，Atlassian ! 
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GitLab 上 自行 管理 的 协作 





GitLab 是 一 个 用 于 仓库 管理 的 开源 代码 托管 系统 。 它 允许 你 跟踪 仓库 中 的 issue， 实 施 代 码 
评审 以 及 通过 Wiki 页 面 创建 辅助 的 项 目 文档 ， 换 名 话说 ， 它 与 GitHub 和 Bitbucket 几乎 相 
同 。GitLab 特有 的 优点 是 ， 它 是 一 个 开源 产品 ， 你 不 需要 支付 版 权 费 用 即 可 在 任何 地 方 安 
装 这 个 软件 ， 而 且 可 以 直接 扩展 这 个 软件 ， 不 会 因 受 到 限制 而 不 能 通过 API 和 其 他 钩子 来 
创建 插件 。 

完成 本 章 学 习 之 后 ， 你 将 具备 以 下 技能 。 

。 找到 所 有 安装 相关 的 指令 来 完成 设置 

。 创建 新 项 目 、 新 用 户 和 新 群 组 

。 配置 项 目的 访问 控制 

。 建立 项 目 间 的 里 程 碑 

本 章 主要 介绍 你 作为 GitLab 实例 的 管理 员 能 够 执行 的 特殊 任务 ， 而 不 只 是 作为 项 目 负 责 人 
使 用 软件 。 


12.1 入 门 


如 果 你 一 开始 就 遵循 了 本 书 中 的 活动 ， 那 么 已 经 创建 了 一 个 仓库 ， 并 且 在 GitLab 的 公开 版 
本 GitLab.com 中 熟悉 了 GitLab 的 仓库 。( 如 果 你 需要 回顾 一 下 ， 可 以 查看 第 5 章 中 介绍 的 
作为 单 人 团队 使 用 GitLab 的 说 明 。) 













































































12.1.1 安装 GitLab 
为 了 利用 本 章 剩余 部 分 中 介绍 的 管理 功能 ， 你 应 该 创建 一 份 本 地 GitLab 实例 ， 以 管理 账 
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户 持 有 人 身份 登录 。 本 章 介 绍 的 是 社区 版 ， 而 不 是 GitLab 的 企业 版 。 企 业 版 需要 付费 ， 
并 提供 了 额外 的 功能 ， 例 如 JIRA 集成 。 你 可 以 在 功能 对 比 清单 (https://about.gitlab.com/ 
features/#compare) 中 查看 两 者 的 差异 。 

安装 GitLab 的 推荐 方式 是 使 用 Omnibus 安装 包 (https://about.gitlab.com/downloads/) 。 这 个 
包 可 以 直接 下 载 并 放置 于 一 台 Linux 服务 器 上 ， 或 通过 一 些 配 置 服务 一 键 安装 部 署 。 
DigitalOcean 提供 GitLab 的 一 键 安 装 包 (https://www.digitalocean.com/products/one-click- 
apps/gitlab/) 。 这 个 安装 包 使 用 Omnibus 的 GitLab 安装 程序 ， 这 意味 着 如 果 存 在 新 功能 
或 漏洞 发 布 ， 你 可 以 轻松 地 升级 GitLab。 在 本 书 编写 时 ，DigitalOcean 是 唯 家 提供 
Omnibus 安装 包 的 一 键 安装 程序 的 服务 商 。Bitnami 和 AWS 市 场 只 提供 从 源 安 装 包 部 署 ， 
在 部 署 后 无 法 升级 。 仔 细 陪 读 说 明 ， 确 保 你 不 会 被 某 个 特定 版 本 的 安装 绑 定 。 

为 了 避免 使 用 GitLab 时 的 托管 费用 ， 你 还 可 以 在 本 地 使 用 虚拟 机 安装 。( 没 有 听 上 去 那么 
可 怕 。) VirtualBox 和 Vagrant 是 在 Windows 和 OS X 机 器 上 配置 Linux 服务 器 最 简单 的 方 
法 。Vagrant 的 书面 文档 非常 优秀 ， 但 如 果 你 倾向 于 通过 视频 学 习 ， 可 以 参考 我 收集 的 一 
些 稍 旧 版 本 的 Vagrant 系列 视频 (https://drupalize.me/videos/why-vagrant)。 基 本 用 法 没有 
变化 。 

一 般 来 说 ， 步 又 如 下 。 

(1) 安装 Virtualbox (https://www.virtualbox.org/wiki/Downloads) , 

(2) 安装 Vagrant (http://www.vagrantup.com/downloads ) 。 

如 果 你 正在 使 用 OS X， 已 经 有 一 个 Virtualbox fH Vagrant 的 brew 范例 ， 那 么 可 以 直接 使 用 。 
当 这 两 个 安装 包 安 装 后 ， 你 现在 可 以 在 你 的 本 地 机 器 上 运行 一 个 Ubuntu 服务 器 。 不 过 ， 虚 
拟 机 不 会 预 安装 GitLab。 此 时 ， 你 可 以 通过 之 前 提 到 的 Ominbus 安装 包 来 安装 GitLab， 但 
我 发 现下 面 的 GitLab 安装 程序 (https://github.com/tuminoid/gitlab-installer) 非常 易于 使 用 。 
在 命令 行 中 完成 以 下 步骤 。 

(1) 从 GitHub 上 克隆 安装 项 目 ， 如 下 所 示 。 


$ git clone https://github.com/tuminoid/gitlab-installer.git 


(2) 在 仓库 内 ， 将 Ruby 配置 文件 的 名 称 从 gitlab.rb.example 改 为 gitlab.rb。 
(3) 启动 虚拟 机 ， 如 下 所 示 。 


$ vagrant up 
新 的 虚拟 机 将 准备 好 。 用 户 名 和 密码 将 会 在 Vagrant 启动 消息 的 结尾 输出 。 如 果 你 记 不 住 


E, 或 者 已 经 关闭 了 该 窗口 ， 也 可 以 从 安装 脚本 结尾 (https://github.com/tuminoid/gitlab- 
installer/blob/master/install-gitlab.sh) 找到 该 信息 。 
























































从 源 代码 安装 

如 果 你 真 的 希望 从 源 代码 安装 GitLab， 在 安装 指南 (https://about.gitlab.com/ 
installation/) 中 有 关于 如 何 继 续 的 说 明 。 强 烈 建议 不 要 这 么 做 ， 因 为 GitLab 
在 每 月 22 号 会 发 布 一 个 软件 的 新 版 本 。 使 用 安装 包 会 使 更 新 你 的 GitLab 实 
例 容易 得 多 。 
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不 论 你 选择 哪 种 安装 方法 ， 都 需要 以 管理 员 身份 登录 你 的 新 GitLab 实例 来 学 习 本 章 剩余 内 
容 。 一 旦 你 登录 之 后 ， 将 会 出 现 图 12-1 中 所 示 的 欢迎 页 面 。 




















Dashboard Q BeB 如 二 可 只 | 


Welcome to GitLab! 


Self hosted Git management application 


You don't have access to any projects right now. 


You can create up to 10000 projects. 


十 New Project 


You can create a group for several dependent projects 
Groups are the best way to manage projects and members. 














图 12-1; GitLab 的 欢迎 页 面 

如 果 你 无 法 完成 安装 ， 我 鼓励 你 快速 浏览 本 章 剩余 内 容 ， 看 看 你 能 够 获得 什么 好 处 ， 确 认 
它 是 否 值得 你 完成 安装 。 

12.1.2 设置 管理 账户 

你 或 许 会 选择 保留 一 个 通用 的 管理 账户 ， 或 在 与 团队 一 起 开发 软件 时 将 它 作 为 你 自己 的 账 
户 。 出 于 习惯 ， 我 倾向 于 创建 一 个 拥有 较 少 权限 的 账户 用 于 日 常 使 用 ， 并 维护 根 账户 ， 用 
于 安装 新 插件 、 升 级 软件 等 任务 以 及 其 他 管理 性 任务 。 

要 配置 你 的 账户 ， 请 完成 以 下 步骤 。 


(1) 在 顶部 菜单 中 ， 找 到 并 点 击 个 人 资料 设置 图 标 (人像 )。 
(2) 在 左 侧 边 栏 中 ， 检 查 个 人 资料 设置 页 面 中 的 每 一 项 。 

















。 个 人 资料 
你 的 姓名 和 公开 的 详细 信息 ， 如 Skype 和 Twitter。 
。 账户 
私有 令 牌 、 双 重 身份 验证 、 用 户 名 和 删除 账户 的 能 
。 应 用 
管理 将 GitLab 作为 OAuth 提供 者 的 应 用 以 及 你 已 授权 使 用 你 的 账户 的 应 用 。 
。 电子 邮件 


主要 电子 邮件 (头像 、 提 交 积 分 )、 通 知 电子 邮件 和 公开 电子 邮件 (显示 的 电子 邮 
件 )。 其 中 任意 一 个 地 址 可 以 用 于 连接 你 的 提交 。 
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密码 

重 设 你 的 密码 。 

通知 

你 的 通知 电子 邮件 以 及 你 的 通知 层级 。 默 认 情 况 下 ， 你 将 会 受到 相关 资源 〈 你 的 提 
交 和 资产 等 ) 的 通知 。 你 也 可 以 选择 Watch (给 定 项 目的 所 有 通知 )、Mention (只 
有 在 issue 或 评论 中 被 @ 到 时 ) 或 Disabled (不 接受 任何 通知 )。 


SSH 44 

注意 : 如果 你 通过 SSH 密 钥 登 录 到 账户 中 ， 那 么 将 无 法 通过 SSH 连接 仓库 。 此 时 
将 会 出 现 提 醒 ， 直 到 提醒 被 关闭 或 你 上 传 了 SSH 密 钥 为 止 。 

设计 

侧 边栏 的 配色 设置 或 代码 语法 高 亮 

历史 

该 账户 创造 的 所 有 活动 。 包 括 你 进行 的 操作 ， 例 如 提交 、 创 建新 项 目 等 。 





一 旦 你 配置 好 了 管理 账户 ， 就 可 以 继续 下 一 步 。 如 果 你 决定 立刻 创建 另 一 个 账户 ， 请 跳 到 
12.3 节 。 


12.1.3 ”管理 信息 中 心 
以 管理 用 户 身份 登录 后 ， 你 将 能 够 访问 一 些 额 外 的 页 面 和 功能 ， 而 公开 的 GitLab.com 网 站 


上 的 非 管理 员 则 无 法 访问 。 大 多 数 功能 可 以 在 Admin area. (管理 区 域 ) 中 找到 。 














在 顶部 莱 单 中 ， 点 击 标签 为 Admin area (管理 区 域 ) 的 齿轮 图 标 。 此 时 将 会 出 现 图 12-2 中 
所 示 的 页 面 。 























Admin area a O00 +m 
Statistics Features Components 
Forks 0 Signup @ Gitlab 7.11.4 
Issues 0 LDAP GitLab Shell 2.6.3 
Merge Requests 0 Gravatar © GitLab API v3 
Notes 0 OmniAuth Ruby 2.1.6p336 
Snippets 0 Rails 4.1.9 
SSH Keys 
Milestones 
Active Users 

Projects Users Groups 
Latest projects Latest users Latest groups 








图 122: 管理 信息 中 心包 括 项 目 详细 信息 摘要 和 GitLab 安装 版 本 的 状态 报 
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这 





个 页 面 提供 了 该 GitLab 实例 安装 的 组 件 摘要 ， 包 括 你 安装 的 GitLab、GitLab 命令 行 、 











GitLab API, Ruby 和 Rails 的 软件 版 本 。 还 有 一 列 可 用 的 功能 ， 并 用 状态 指示 灯 显 示 哪 些 
功能 已 启用 。 在 图 12-2 中 ， 你 可 以 看 到 Sign up (注册 ) 和 Gravatar 被 启用 ， 而 LDAP 和 


OmniAuth 被 禁用 。 封 财 的 圆圈 是 绿色 的 ， 代 表 “ 打 开 ”;， 而 “关闭 ”符号 是 代表 待机 的 图 



































标 。 不 幸 的 是 ， 这 些 图 标 是 通过 CSS 本 身 提供 的 ， 目 前 不 提供 等 价 的 文本 描述 。 
以 下 是 左 侧 边栏 中 的 选项 ， 其 中 每 个 选项 的 含义 都 一 目 了 然 。 











Overview (概览 ) 

即 你 在 图 12-2 中 看 到 的 页 面 。 提 供 站 点 的 快速 状态 概览 ， 以 及 创建 新 用 户 、 新 项 目 和 
新 群 组 的 快速 链接 。 

Projects (A B) 

在 站 点 内 搜索 项 目 ， 提 供 按 每 个 用 户 、 不 活跃 〈 最 近 6 个 月 无 活动 ) 和 可 见 层级 CR. 
有 、 内 部 或 公开 ) 的 筛选 。 

Users (用 户 ) 

在 站 点 内 搜索 账户 ， 提 供 按 管理 员 、 封 禁 账户 和 无 项 目 用 户 的 筛选 。 

Groups ( 群 组 ) 
按 名 称 搜索 群 组 ， 或 添加 一 个 新 群 组 。 此 页 面 不 提供 筛选 。 

Deploy keys. (部 署 密 钥 ) 

所 有 用 于 部 署 的 密 钥 列表 ， 你 也 可 以 在 此 页 面 中 添加 新 的 密 钥 。 

Logs (日 志 ) 

githost.log、application.log、production.log 和 sidekiq.log 中 的 每 一 个 的 最 后 2000 行 。 
























































Messages (消息 ) 
向 所 有 系统 账户 添加 定时 广播 消息 的 能 力 。 可 用 于 计划 维护 、 近 期 升级 等 。 


System hooks (系统 钩子 ) 
所 有 现 有 系统 钩子 的 列表 。 在 钧 子 列表 中 ， 你 可 以 测试 一 个 钩子 或 移 除 它 ， 还 可 以 在 此 
页 面 上 添加 新 的 钧 子 (URL), 


Background jobs (5 & 4£ 4-) 

在 sidekiq (http://sidekiq.org/) 中 运行 的 后 台 任 务 摘 要 。 
System OAuth applications (系统 OAuth 应 用 ) 
现 有 应 用 的 列表 和 添加 新 应 用 的 能 力 (标题 和 跳 转 URI 字段 ) 。 


Service templates (服务 模板 ) 

服务 模板 允许 你 设置 项 目 服务 的 默认 值 。 不 同 的 服务 可 以 选择 不 同 的 设置 项 。 例 如 ， 
如 Asana 和 Buildkite 这 样 的 外 部 服务 有 API 密 钥 字 段 。 如 JIRA、Redmine 这 样 的 服 
务 还 有 配置 字段 [Project URL (项 目 URL), Issues URL, New Issue URL (Xf issue 
URL)]。 如 Email 推送 等 服务 ， 还 有 触发 的 开关 (推送 事件 或 标签 推送 事件 )。 如 果 你 
希望 整合 第 三 方 服务 ， 可 以 快速 浏览 这 个 页 面 。 
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e Application settings (应 用 设置 ) 
包括 默认 的 项 目 设 置 和 全 站 配置 选项 。 


为 了 锁定 你 的 GitLab 实例 ， 你 需要 使 用 Application settings. (应 用 设置 ) 页 面 上 的 不 同 选 
项 。GitLab 上 的 设置 较为 自由 。 默 认 情况 下 ， 应 用 对 新 注册 用 户 开放 ， 后 者 受 限 至 多 拥有 
10 个 仓库 ， 但 新 仓库 的 默认 设置 是 私有 的 。 
Features (功能 ) 栏 包括 以 下 设置 (默认 均 启用 )。 
。 Signup (注册 ) 
允许 人 们 创建 账户 。 
。 Signin (登录 ) 
允许 人 们 进行 验证 。 如 果 你 想 要 一 个 只 读 的 公开 仓库 ， 它 将 是 适合 你 的 选项 。 
e Gravatar (通用 头像 服务 ) 
用 户 个 人 资料 图 片 的 集成 〈 需 要 网 络 连接 ) 。 
* Twitter 
向 用 户 提 供 按钮 来 将 新 建 的 公开 或 内 部 项 目 分 享 到 Twitter 上 。 
e Version check enabled (启用 版 本 检查 ) 
检查 是 否 存在 更 新 版 本 的 GitLab。 


Visibility and access control. (可 见 性 和 访问 控制 ) 包括 以 下 设置 。 
e Default branch protection. (默认 分 支 保护 ) 


















































选项 包括 以 下 几 个 。 
* Not protected. (不 受 保护 ， 开 发 者 和 Master 可 以 推送 提交 、 删 除 分 支 以 及 强制 推送 
新 的 提交 ) 


+ Partially protected. (部 分 保护 ， 开 发 者 可 以 推送 新 的 提交 ，Master 可 以 进行 任何 更 改 ) 
* Fully protected (完全 保护 ， 只 有 Master 可 以 在 仓库 中 进行 更 改 )。 
默认 情况 下 ，Fully protected 被 启用 。 
e Default project visibility (默认 项 目 可 见 性 ) 
选项 包括 以 下 几 个 。 
€ Private (私有 ， 为 每 个 用 户 明确 授权 项 目 访问 ) 
4 Internal (内 部 ， 项 目 可 以 被 任何 登录 用 户 克 隆 ) 
* Public (公开 ,项 目 不 需 要 任何 验证 即 可 被 克隆 )。 
默认 情况 下 ，Private 被 启用 。 
e Default snippet visibility (默认 便签 可 见 性 ) 
选项 包括 Private (私有 ). Internal (内 部 ) FH Public (公开 )。 默 认 情 况 下 ，Private 被 
启用 。 
e Restricted visibility levels 〈 受 限 可 见 性 等 级 ) 
选中 的 等 级 无 法 用 于 项 目 或 便签 的 非 管理 员 用 户 。 





cá 
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Restricted domains for sign-ups 〈 受 限 注 册 域 名 ) 
只 允许 拥有 指定 域名 的 电子 邮件 账户 的 用 户 创建 账户 。 可 使 用 通配符 。 


还 有 以 下 这 些 限制 设置 。 


最 


Default projects limit. (默认 项 目 限制 ) 

默认 情况 下 ， 每 个 账户 允许 拥有 10 个 仓库 ， 包 括 开发 者 需要 向 项 目 提交 合并 提交 的 私 
有 派生 。 如 果 开 发 者 同时 进行 多 个 内 部 项 目 ， 这 个 数字 可 能 需要 增加 。 

Maximum attachment size. (附件 大 小 限制 ，MB) 

默认 情况 下 ， 这 个 值 被 设 为 10MB 。 对 大 多 数 屏幕 截图 来 说 应 该 已 经 足够 ， 但 如 果 你 还 
想 要 在 issue 后 附加 设计 资源 ， 这 个 值 可 能 不 够 大 。 




















后 ， 还 有 以 下 这 些 登 录 限 制 。 


Home page URL (首页 URL) 

未 验证 用 户 在 访问 除了 注册 页 面 以 外 的 任何 页 面 时 ， 应 该 被 重 定向 到 URL. AR 
置 ， 人 们 将 会 被 重 定向 到 登录 页 面 。 
Sign in text (登录 文本 ) 

这 个 文本 出 现在 登录 页 面 中 GitLab 的 描述 下 方 。 你 应 该 用 一 个 标题 分 离 你 的 文本 和 
GitLab 的 描述 。 















































通过 配置 每 个 选项 ， 你 可 以 为 你 的 GitLab 实例 创建 一 个 合适 的 起 点 。 例 如 ， 如 果 你 希望 让 
它 仅 为 批准 的 人 员 进 行 官方 工作 提供 服务 ， 则 可 以 调整 以 下 这 些 选 项 。 





禁用 注册 功能 。 

禁用 Twitter 功能 (从 界面 上 移 除 鼓励 发 推 文 的 按钮 ) 

设置 Restricted visibility levels ( 受 限 可 见 性 等 级 )， 禁 用 公开 仓库 和 便签 (查看 所 有 仓 
库 需 要 登录 )。 





如 果 你 希望 让 你 的 实例 更 加 开放 一 些 ， 则 可 能 会 像 下 面 这 样 调整 设置 。 














启用 注册 功能 。 

禁用 Twitter 功能 。 
禁用 非 管理 员 的 公开 仓库 。 
限制 域名 ， 只 有 你 的 组 织 成 员 可 以 广 册 。 











除了 这 些 设置 外 ， 你 可 以 进一步 自 定义 每 个 项 目的 设置 来 满足 你 的 需求 。 


12.2 项 目 

你 的 组 织 或 许 已 经 有 了 一 些 代码 项 目 ， 可 能 使 用 或 没有 使 用 Git 进行 版 本 管理 。 为 了 在 
GitLab 中 开始 你 的 设置 流程 ， 你 或 许 会 想 要 从 成 员 或 项 目 开 始 。 从 项 目 开始 的 好 处 是 : 人 
们 第 一 次 登录 后 已 有 可 以 参与 的 项 目 。 如 果 你 和 经 验 丰富 的 Git 用 户 一 起 工作 ， 你 或 许 会 


希 


望 授权 少数 人 先 去 设置 项 目 。 
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创建 项 目 

项 目 事 实 上 是 一 个 提供 issue 队列 和 Wiki 页 面 等 支持 工具 的 仓库 。 在 GitLab 中 创建 新 项 目 

时 ， 你 可 以 选择 从 GitHub, Bltbucket, Gitorious, Google Code 或 任何 其 他 你 的 GitLab 实 

例 可 以 通过 URL 访问 到 的 仓库 导入 。 

要 创建 新 项 目 ， 请 完成 以 下 步骤 。 

(1) 在 菜单 顶部 ， 找 到 并 点 击 New repository (新 建仓 库 ) 图 标 。 这 个 图 标 是 一 个 +。 此 时 
将 会 显示 项 目 创 建 表单 。 

(2) 完成 图 12-3 中 新 项 目 需要 的 下 列 每 个 字段 。 





























p 


New Project 


conca E 


Project path .git 


Namespace Administrator 


Import project O GitHub 9 Bitbucket «9 GitLab.com B Gitorious.org 8 Google Code 


from g 
git Any repo by URL 


Description 
(optional) 


Visibility Level () © @ Private 
Project access must be granted explicitly for each user. 


U internal 
The project can be cloned by any logged in user. 


@ Public 
The project can be cloned without any authentication. 


| Create project | Need a group for several dependent projects? | Create a group 











12-3: 新 项 目 创建 表单 


。 Project path (项 目 路 径 ) 
你 的 项 目 页 面 的 URL。 仅 可 使 用 小 写字 符 和 连 字 符 。 


。 Namespace (命名 空间 ) 
这 个 项 目 应 该 归属 的 账户 或 群 组 名 称 。 默 认 情况 下 ， 会 选中 你 自己 的 账户 。 


e Import project from (导入 项 目 ) 
如 果 项 目 已 经 存在 ， 你 可 以 从 列 出 的 服务 之 一 中 导入 。GitLab 必须 能 够 访问 那个 服 
务 以 完成 导入;， 换 句 话说， 仓库 不 能 位 于 无 法 联网 的 防火 墙 后 ， 而 你 需要 启用 项 目 
的 OAuth 访问 。 弹 出 窗口 中 的 说 明 (图 12-4) 会 将 你 带 到 你 想 要 连接 的 服务 的 相关 
文档 页 面 。 




















220 | 第 12 章 





Import projects from GitHub 








To enable importing projects from GitHub, you need to setup OAuth integration. 





12-4: 在 点 击 GitHub 按钮 后 ， 将 会 显示 此 弹出 窗口 ， 告 诉 你 GitLab 没有 从 GitHub 中 导入 的 权限 
。 Description (描述 ) 
用 于 列表 中 的 项 目 信 息 。 它 不 是 一 份 完整 的 README, 


。 Visibility Level (可 见 性 层级 ) 
在 Private (MA, RAWEA IL), Interna (内 部 ， 所 有 登录 用 户 可 见 ) 或 
Public (公开 ， 对 任何 网 站 的 访问 者 可 见 ) 中 选择 。 


(3) 找到 并 点 击 Create project. (创建 项 目 ) 按钮 。 


你 的 新 项 目 已 经 创建 。 如 果 你 选择 从 外 部 服务 中 导入 ， 仓 库 、issue 和 Wiki 页 面 将 会 被 导 
入 (如 果 支 持 )。 此 时 将 会 显示 新 项 目 页 面 。 


在 项 目 导 入 后 ， 你 现在 可 以 为 项 目 添加 管理 员 和 开发 者 。 


12.3 用户 账户 
GitLab 人 允许 你 创建 特定 角色 的 用 户 。 这 些 角色 可 以 用 于 调整 项 目的 读 写 权限 。 如 果 你 熟悉 


Subversion 的 分 支 锁 定 ， 对 这 些 访问 限制 也 不 会 陌生 。 在 本 节 中 ， 你 将 学 到 如 何 设置 每 个 
用 户 账户 并 为 项 目 添加 成 员 。 


12.3.1 创建 用 户 账户 

要 创建 一 个 新 用 户 账户 ， 你 可 以 从 几 个 不 同 地 方 开始 。 最 容易 访问 的 是 从 管理 区 域 的 概览 
中 ， 步 又 如 下 。 

(在 右上 方 点 击 标签 为 Admin area. (管理 区 域 ) 的 齿轮 图 标 。 此 时 将 会 显示 管理 区 域 的 概 


览 页 面 。 
(2) 找 到 并 点 击 New user. (新 建 用 户 ) 按钮 。 此 时 将 会 显示 新 用 户 创建 表单 。 
这 个 表单 ， 如 图 12-5 所 示 ， 被 分 为 了 三 个 区 域 : Account (账户 )、Access (访问 ) 和 
Profile (个 人 资料 )。 
Account (账户 ) 部 分 中 的 字段 都 是 必 填 字段 ， 包 括 以 下 这 些 。 
* Name (姓名 ) 
账户 的 显示 名 称 。 
。 Username (用 户 名 ) 
账户 的 登录 名 。 
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New user 


Account 
Name 
* required 
Username 
* required 
Email 
* required 
Password 
Password Reset link will be generated and sent to the user. 
User will be forced to set the password on first sign in. 
Access 
Projects limit 10 
Can create group 9 
Admin 
Profile 
Avatar Choose File No file chosen 
Skype 
Linkedin 
Twitter 
Website 


| Cresteuser | bouis 











12-5. 新 用 户 账户 创建 表单 被 分 成 三 个 区 域 ， Account (账户 ， 必 填 字 段 )、Access (访问 ) 和 
Profile (个 人 资料 ) 
。 Email (电子 邮件 ) 
账户 的 电子 邮件 地 址 。 
Access (访问 ) 部 分 中 的 字段 的 默认 值 通常 是 适当 的 ， 包 括 以 下 这 些 。 
。 Project limit (项 目 限制 ) 
默认 数量 是 你 之 前 为 全 站 设置 的 值 。GitLab 将 默认 值 设 为 10。 
e Can create group (能 够 创建 群 组 ) 
聚合 项 目的 能 力 。 这 个 功能 在 其 他 系统 中 被 为 团队 或 组 织 。 这 个 选项 默认 启用 。 
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* Admin (管理 员 ) 
允许 该 用 户 管理 GitLab 软件 。 这 个 选项 默认 启用 。 
最 后 ， 还 有 一 个 Profile (个 人 资料 ) 部 分 ， 其 中 包含 以 下 几 个 用 于 上 传 照 片 和 社交 媒体 链 
接 的 字段 。 
。 Avatar 一 一 如 果 Gravatar 已 启用 ， 则 不 必 上 传单 独 的 用 户 个 人 资料 图 片 
。 Skype 
* LinkedIn 


* Twitter 
e Website (网 站 ) 


尽管 你 可 以 花 些 时 间 在 填写 个 人 资料 详细 信息 上 ， 但 不 是 所 有 员工 都 想 要 在 工作 系统 中 绑 
定 他 的 社交 账户 。 将 它们 留 空 可 能 会 更 合适 。 


要 创建 用 户 帐户， 请 完成 以 下 步骤 。 


(填写 之 前 描述 过 的 Account. (账户 ) 详细 信息 。 

(2) 确认 Account 详细 信息 正确 。 

(3) 检查 Profile 详细 信息 ， 确 保 将 它们 留 空 。 填 写 任何 现在 适合 添加 的 详细 信息 。 
(4) 找到 并 点 击 Create user (创建 用 户 ) 按钮 。 


新 用 户 账户 已 经 创建 ， 一 封 通知 邮件 已 经 发 送 给 该 用 户 ， 包 括 一 个 可 供用 户 设置 密码 的 一 
次 性 登录 链接 。 


除了 这 个 手动 账户 创建 以 外 ，GitLAN 还 集成 了 LDAP (https;//docs.gitlab.com/ce/administration/ 
auth/Idap.html) 和 OmniAuth (https://docs.gitlab.com/ce/integration/omniauth.html) , GitLab 的 文档 
中 介绍 了 这 种 类 型 的 访问 的 设置 。 在 本 书 编写 时 ， 支 持 OmniAuth 的 服务 提供 商 包 括 GitHub, 
Twitter 和 Google。 


12.3.2 ”添加 项 目 成 员 
要 在 项 目 中 添加 成 员 ， 请 完成 以 下 步骤 。 


(1) 前 往 项 目 页 面 。 

Q) 从 侧 边栏 中 找到 并 点 击 Settings (设置 )。 

(3) 在 左 侧 边栏 中 ， 找 到 并 点 击 Members (成 员 ) 。 

(4) 找到 并 点 击 Add members. (添加 成 员 )。 此 时 将 打开 一 个 新 表单 (图 12-6)。 

(5) 在 标签 为 People (AR) 的 字段 中 ， 输 入 你 想 要 添加 到 项 目的 成 员 的 用 户 名 或 电子 
邮件 。 

(6) 将 标签 为 Project Access. (项 目 访问 ) 的 字段 调整 为 下 列 各 项 之 一 。 


。 Guest (访客 ) 
能 够 查看 项 目 、 创 建 issue 和 留 下 评论 


。 Reporter (报告 者 ) 
能 够 克隆 仓库 、 创 建 代码 片段 
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New group 


Group path https://127.0.0.1:8443/ open-source 
Details 
Group avatar & ChooseFile.. File name... 


The maximum file size allowed is 200KB. 


+ A group is a collection of several projects 
+ Groups are private by default 
* Members of a group may only view projects they have permission to access 


* Group project URLs are prefixed with the group namespace 
* Existing projects may be moved into a group 





Create group Cancel 











图 12-6. 将 用 户 添加 到 项 目 ， 搜 索 人 员 并 设置 合适 的 访问 级 别 
。 Developer (开发 者 ) 
能 够 向 授权 的 分 支 提交 代码 


* Master 
项 目 管理 员 


。 Owner (所 有 者 ) 
能 够 移 除 项 目 


(7) 找到 并 点 击 Add users to project. (添加 项 目 成 员 )。 
这 些 账 户 被 授予 了 合适 的 项 目 访问 权限 。 如 果 电 子 邮 件 尚未 在 GitLab 的 这 个 示例 中 注册 ， 


则 会 发 送 一 封闭 请 邮件 ， 请 求 用 户 注册 。 
12.4 ”和 群 组 


为 了 收集 项 目 ， 你 可 以 使 用 群 组 。 你 可 以 将 群 组 视 为 一 个 部 门 、 组 织 或 (包含 子 项 目的 ) 
软件 项 目 。 默 认 情 况 下 ， 群 组 是 私有 的 ， 只 有 该 群 组 的 成 员 可 以 查看 群 组 中 的 项 目 。 
每 个 人 都 可 以 创建 群 组 
默认 情况 下 ， 所 有 在 GitLab 上 有 账户 的 人 都 有 权限 创建 一 个 群 组 ， 你 可 以 在 
账户 创建 后 或 从 账户 的 设置 页 面 ， 禁 用 某 个 账户 的 该 权限 。 


要 创建 新 群 组 ， 请 完成 以 下 步骤 。 
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(从 顶部 菜单 栏 中 ， 点 击 Admin area (管理 区 域 )】 的 齿轮 图 标 。 


Q) 找到 并 点 击 New group. 〈 新 建 群 组 )。 此 时 将 会 显示 群 组 创建 表单 (K 12-7)。 


(3) 输入 每 个 表单 字段 的 详细 信息 。 
e Group path. ( 群 组 路 径 ) 





该 群 组 使 用 的 URL 片段 。 你 只 能 输入 小 写字 母 和 连 字 符 。 在 URL 中 ， 它 的 用 法 与 


用 户 名 相同 。 
。 Details (详细 信息 ) 


你 的 团队 、 组 织 、 软 件 项 目的 简单 描述 ， 也 就 是 “关于 ”或 “ 


。 Group avatar ( 群 组 头像 ) 
群 组 显示 的 图 标 。 


生平 ”字段 。 


(4) 找到 并 点 击 Create group. (创建 群 组 )。 此 时 将 会 显示 项 目的 管理 页 面 。 





New group 
Group path https://127.0.0.1:8443/ open-source 
Details 
Group avatar &ChooseFile.. Filename... 


The maximum file size allowed is 200KB. 


* Agroup is a collection of several projects 

* Groups are private by default 

* Members of a group may only view projects they have permission to access 
* Group project URLs are prefixed with the group namespace 


* Existing projects may be moved into a group 








Cancel 








& 12-7. 创建 一 个 新 群 组 
你 的 新 群 组 已 经 创建 。 你 现在 可 以 为 你 的 群 组 添加 成 员 和 项 目 。 


12.4.1 添加 群 组 成 员 





权限 主要 在 项 目 中 设置 ， 而 不 是 在 群 组 中 。 然 而 ， 如 果 用 户 被 授权 担任 团队 中 的 特殊 角 





色 ， 那 么 他 们 能 够 执行 下 面 一 些 其 他 操作 。 
。 所 有 人 都 能 浏览 群 组 。 


。 RA Owner (所 有 者 ) 可 以 编辑 群 组 ， 管 理 群 组 成 员 和 删除 群 组 。 





。 和 群 组 的 Master 也 可 以 在 群 组 中 创建 项 目 。 
要 在 群 组 中 添加 成 员 并 为 他 分 配角 色 ， 请 完成 以 下 步骤 。 
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(1) 在 顶部 菜单 中 ， 点 击 Admin area (管理 区 域 ) 的 齿轮 图 标 。 
(2) 在 左 侧 边栏 中 ， 点 击 Groups 菜单 链接 。 此 时 将 会 显示 群 组 管理 页 面 。 
(3) 找到 表单 来 向 群 组 添加 用 户 (图 12-8)。 














Group: neverending-story ( Edit 


^" 


Group info: Add user(s) to the group: 


Read more about project permissions here 


Name: neverending-story 


Guest 
Path: neverending-story 
Description: Add users to group 
Created on: June 15, 2015 
Members @ 
Projects Q E 
Administrator Owner 58 











12-8: 将 用 户 添加 到 群 组 


(4) 为 每 个 你 想 要 添加 到 群 组 的 用 户 输入 以 下 详细 信息 。 


。 Username (用 户 名 ) 
你 可 以 添加 多 个 具有 同一 角色 的 用 户 (图 12-9), 








Add user(s) to the group: 


Read more about project permissions here 


x Morla || x Engywook | | x Atreyu | | x Falkor 


Developer 


Add users to group 











12-9: 你 可 以 在 群 组 中 同时 添加 多 个 用 户 ， 只 要 他 们 的 角色 相同 即 可 


* Role (角色 ) 
选择 Guest (访客 )、Reporter (报告 者 )、Developer (开发 者 )、Master 或 Owner 
(所 有 者 ) 中 的 一 个 。 


(5) 点 击 Add users to group. (将 用 户 添加 到 群 组 )。 
只 有 至 少将 一 个 项 目 添加 到 群 组 中 ， 群 组 才 可 见 。 
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12.4. ”将 项 目 添加 到 群 组 

将 项 目 添加 到 群 组 很 简单 ， 只 是 将 命名 空间 调整 为 群 组 ， 而 不 是 单个 账户 。 

要 在 群 组 中 创建 新 项 目 ， 请 完成 以 下 步 又 。 

(在 顶部 菜单 中 ， 点 击 标签 为 New project (新 项 目 ) 的 + 图标 。 

(2) 输 入 Project path. (项 目 路 径 ) ， 仅 可 使 用 小 写字 母 和 连 字符 。 

(3) ££ Namespace. (命名 空间 ) 标签 的 旁边 ， 点 击 下 拉 箭 头 并 选择 合适 的 群 组 (图 12-10). 
(4) 与 你 之 前 创建 新 项 目 时 一 样 ， 完 成 每 个 字段 的 填写 。 

(5) 点 击 Create project. (创建 项 目 ) 。 





Project path sea-of-possibilities .git 
Namespace Administrator 
Groups 


coffee-shops 


Users 








Administrator 





图 12-10; Sea of Possibilities 项 目 被 添加 到 Neverending Story 群 组 


新 项 目 已 经 创建 ， 并 可 用 于 开发 。 

如 果 项 目 已 经 存在 ， 而 你 希望 将 它 移 到 一 个 不 同 的 命名 空间 (不 同 账户 或 群 组 )， 请 完成 
以 下 步骤 。 

(1) 在 顶部 菜单 中 ， 点 击 Admin area (管理 区 域 ) 的 齿轮 图 标 。 

DEEH, Ark Projects (ME). 

(3) 找到 你 想 要 重新 分 配 的 项 目 并 点 击 它 的 名 称 。 此 时 将 会 显示 这 个 项 目的 管理 摘要 。 

(4) 找到 项 目 转移 表单 (图 12-11)。 























Transfer project 


Namespace 


=a 


& 12-11: 项 目 转移 表单 允许 你 将 项 目 移动 到 一 个 不 同 的 命名 空间 


(5) 在 项 目 转移 表单 中 ， 点 击 下 拉 框 中 的 下 箭头 。 此 时 将 会 显示 群 组 和 用 户 列表 。 选 择 你 想 
要 将 项 目 转移 到 的 群 组 。 
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(6) 点 击 Transfer. (转移 )。 


项 目 已 经 被 转移 到 新 的 群 组 。 之 前 的 群 组 成 员 将 不 再 拥有 项 目的 权限 。 拥 有 项 目 本 地 克隆 
的 用 户 需 要 更 新 项 目的 新 命名 空间 的 URL. (阅读 第 5 章 来 了 解 使 用 远程 的 详细 信息 )。 


12.5 访问 控制 


项 目 可 见 性 设置 和 每 个 账户 角色 的 设置 都 可 以 限制 项 目 访问 。 有 了 这 两 个 选项 ， 你 可 以 灵 
活 地 掌握 项 目 是 如 何 管理 的 。 在 第 2 章 中 ， 你 学 到 了 连接 仓库 的 许多 不 同方 式 ， 让 人 们 拥 
有 正确 的 访问 等 级 。 使 用 GitLab 细致 的 管理 ， 你 可 以 确保 每 个 人 的 实际 权限 与 你 希望 他 们 
得 到 的 权限 相同 。 


12.5.1 项 目 可 见 性 
在 给 定 项 目 中 ， 你 可 以 控制 每 个 项 目 和 每 个 角色 的 访问 等 级 。 


。 Private (私有 ) 
为 每 个 用 户 明确 授权 项 目 访问 


。 Internal (内 部 ) 
项 目 可 以 被 任何 登录 用 户 克 隆 


。 Public (公开 ) 
项 目 不 需 任何 验证 即 可 被 克隆 


要 调整 项 目的 可 见 性 设置 ， 请 完成 以 下 步骤 。 


(1) 在 顶部 菜单 中 ， 点 击 Admin area (管理 区 域 ) 的 齿轮 图 标 。 

(2) 在 左 侧 边 栏 中 ， 点 击 Projects (项 目 )。 

(3) 找到 你 想 要 调整 的 项 目 并 点 击 它 的 名 称 。 

(4) 在 项 目 管理 摘要 页 面 中 ， 找 到 并 点 击 edit (编辑 ) 按钮 。 

(5) 找到 表单 中 的 Visibility Level (可 见 性 ) 部 分 (图 12-12) 并 调整 你 希望 人 们 拥有 的 访 
问 等 级 〈 私 有 、 内 部 或 公开 ) 。 

(6) 找到 并 点 击 Save changes. (保存 更 改 )。 






































Visibility Level (?) © @ Private 
Project access must be granted explicitly for each user. 


U Internal 
The project can be cloned by any logged in user. 


@ Public 
The project can be cloned without any authentication. 











图 12-12. 将 项 目 可见 性 更 新 为 Public (47), Internal (内 部 ) 或 Private (私有 ) 中 的 一 个 


你 的 项 目 可 见 性 设置 已 经 调整 完毕 。 





228 | 第 12 章 


12.5.2 ”使 用 项 目 角色 限制 活动 


一 旦 用 户 能 够 看 到 一 个 项 目 ， 你 就 可 以 通过 为 每 人 分 配 一 个 特定 的 角色 ， 进 一 步 控制 他 们 
能 够 在 仓库 中 进行 的 活动 。 你 可 以 在 你 安装 的 GitLab 中 从 目录 help/permissions/permissions 
看 到 所 有 权限 的 综合 对 照 表 。 


每 个 角色 可 用 的 功能 快速 摘要 如 下 所 示 。 

。 Guest (访客 ) 
能 够 创建 issue 并 留 下 评论 ， 仅 此 而 已 ! 对 于 不 需要 代码 权限 ， 但 需要 参与 到 项 目 开发 
过 程 中 的 利益 干系 人 来 说 很 适合 。 

。 Reporter (报告 者 ) 
除了 访客 权限 之 外 ， 报 告 者 能 够 克隆 仓库 并 创建 代码 片段 。 你 可 能 希望 给 CTO 这 个 角 
色 ， 因 为 他 们 应 该 不 再 写 代 码 了 。( 我 只 是 在 开玩笑 。 我 觉得 如 果 经 理 能 够 介入 帮忙 是 
最 好 的 。 我 还 认为 经 理应 该 专注 于 只 有 他 们 能 够 完成 的 外 向 任务 。) 


* Developer (开发 者 ) 
除了 之 前 的 所 有 权限 之 外 ， 开 发 者 还 可 以 创建 新 分 支 、 创 建 合并 请 求 、 推 送 到 不 受 保护 的 
分 支 、 添 加 标签 、 编 写 Wiki 页 面 、 管 理 issue 跟踪 工具 ， 等 等 。 团 队 中 大 多 数 人 将 会 被 分 
配 该 角色 。 你 仍然 可 以 限制 他 们 对 每 个 分 支 的 访问 ， 因 此 现在 权限 宽泛 一 些 也 没 问 题 。 


* Master 
除了 之 前 的 权限 ，Master 还 可 以 创建 里 程 碑 、 添 加 新 的 团队 成 员 、 推 送 到 受 保护 分 支 、 
添加 产品 密 钥 ,并且 编辑 项 目 本 身 。 这 个 角色 适合 团队 负责 人 以 及 想 要 经 常 改变 团队 组 
成 或 访问 的 项 目 经 理 。 


。 Owner (所 有 者 ) 
最 后 的 角色 同样 可 以 改变 项 目 可 见 性 ， 将 项 目 转移 到 另 一 个 命名 空间 ， 以 及 删除 项 目 。 
团队 外 的 管理 员 适 合 拥有 该 角色 。 


要 在 团队 中 更 新 某 个 人 的 角色 ， 请 完成 以 下 步 又 。 


(1) 在 顶部 菜单 中 ， 点 击 Admin area (管理 区 域 ) 的 齿轮 图 标 。 

(2) 在 左 侧 边栏 中 ， 点 击 Projects (项 目 )。 

(3) 找到 你 想 要 更 新 的 项 目 。 在 项 目的 名 称 旁 边 有 一 个 标签 为 edit (编辑 ) 的 按钮 。 点 击 这 
个 按钮 。 你 将 从 管理 区 域 重 定向 到 该 项 目 。 

(4) 在 左 侧 边栏 中 ， 点 击 Members (成 员 )。 

(5) 找到 并 点 击 Edit group members (编辑 群 组 成 员 )。 成 员 列 表 将 会 被 转换 成 一 个 配置 列表 。 

(6) 找到 你 想 要 更 改 角色 的 用 户 ， 点 击 铅笔 图 标 。 一 个 新 的 下 拉 框 将 会 出 现 (图 12-13)。 

(7) 更 新 下 拉 框 ， 使 它 包 含 该 用 户 的 合适 角色 。 

(8) 点 击 Save (保存 )。 
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neverending-story group members (6) 
Š Bastian bastian Developer v B 
Master 
E3 
Engywook engywook Developer (7 B 
Falkor falkor Developer (7 B 
Atreyu atreyu Developer (z B 
Morla moria Developer œ B 








12-13. 更 新 指定 团队 成 员 的 角色 
新 的 角色 已 被 应 用 。 


12.5.3 ”使 用 保护 分 文 限 制 访 问 

GitLab 提供 的 最 终 访问 层级 是 每 个 分 支 的 访问 设置 。 默 认 情 况 下 ，master 分 支 是 受 保护 
的 ， 拥 有 Developer (开发 者 ) 角色 的 用 户 无 法 推送 到 这 个 分 支 。 他 们 需要 使 用 合并 请 求 
流程 来 将 他 们 的 工作 并 入 仓库 中 的 master 分 支 。 如 果 你 倾向 于 使 用 共享 访问 模型 ， 则 可 以 
移 除 这 个 保护 。 


为 了 更 新 指定 项 目 中 受 保护 的 分 支 ， 这 个 分 支 必须 已 经 存在 。 一 旦 它 存 在 于 仓库 中 ， 你 就 

可 以 打开 或 关闭 访问 。( 记 住 ， 当 你 刚 创建 项 目 时 ， 为 新 分 支 选择 的 是 默认 访问 。) 

要 设置 指定 分 支 的 访问 控制 ， 请 完成 以 下 步骤 。 

(D 在 顶部 菜单 中 ， 点 击 Admin area (管理 区 域 ) 的 齿轮 图 标 。 

(2) 在 左 侧 边栏 中 ， 点 击 Projects (项 目 )。 

(3) 找到 你 调整 的 项 目 ， 点 击 名 称 旁 边 标签 为 edit (编辑 ) 的 按钮 。 此 时 将 会 显示 项 目 页 
面 ， 而 不 是 管理 页 面 。 

(4) 在 左 侧 边栏 中 ， 依 次 点 击 Settings (设置 ) 和 Protected branches (分 支 保护 ) 。 

(5) 在 下 拉 菜 单 中 ， 选 择 你 想 要 保护 的 分 支 〈 图 12-14), 

(6) 找到 并 点 击 Protect. (保护 ) 按钮 。 





























Branch fantasia 


Developers can push 


Allow developers to push to this branch 


12-14: 锁定 分 支 ， 以 便 它 仅 可 以 接收 来 自 拥 有 此 项 目 或 团队 的 Master 或 Owner (MAE) 角色 
的 账户 的 更 新 
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Developer (开发 者 ) 角色 将 不 再 能 够 更 新 这 个 分 支 。 
要 移 除 限制 ， 请 在 同一 个 页 面 中 完成 以 下 步骤 。 


(1) 找到 标题 为 Already Protected (已 经 受 保护 ) 的 部 分 (图 12-15), 
(2) 找到 你 想 要 更 新 的 分 支 。 
(3) 点 击 Unprotect (取消 保护 ) 按钮 。 


























Already Protected: 
Branch Developers can push Last commit 
master CZT} 13c7f5f1 - about an hour ago | Unprotec | 








图 12-15. 已 经 受 保护 的 分 支 可 以 被 取消 保护 
现在 ， 拥 有 Developer (开发 者 ) 角色 的 用 户 将 能 够 向 你 刚 更 新 的 分 支 推送 提交 。 


12.6 里程碑 


在 每 个 项 目 中 ， 你 可 以 创建 里 程 碑 。 它 们 被 用 于 收集 issue、 参 与 者 和 截止 日 期 。 如 果 你 使 
用 Scrum 风格 的 敏捷 开发 ， 就 会 发 现 它 们 有 助 于 冲刺 的 启动 。 一 个 群 组 共享 的 项 目 里 程 碑 
可 以 在 一 个 报表 页 面 中 查看 。 这 使 得 项 目 间 的 协调 更 加 容易 。 但 是 ， 它 仍然 是 每 个 仓库 自 
身 的 ， 因 此 无 法 被 当 作 强大 的 项 目 管理 工具 来 允许 你 将 不 同 代码 库 中 的 issue 收集 到 一 个 
项 目 中 以 方便 管理 。 如 果 你 在 群 组 的 所 有 项 目 中 使 用 同一 个 名 称 ， 那 么 也 可 以 偷 个 懒 ， 将 
相关 的 事项 放 在 一 起 。 
要 为 你 的 项 目 创建 一 个 新 的 里 程 碑 ， 请 完成 以 下 步骤 。 
(1) 前 往 项 目 页 面 。 
(2) 在 左 侧 边栏 中 ， 点 击 Milestones (PH), 
(3) 找 到 并 点 击 New milestone. (新 建 里 程 碑 ) 按钮 。 
(4) 为 你 的 新 里 程 碑 完成 以 下 表单 字段 (图 12-16)。 
。 Title (标题 ) 
e Description. (描述 ) ， 附 有 其 他 文件 
。 Date (日 期 ) 
(5) 找到 并 点 击 Create milestone (创建 里 程 碑 ) 按钮 。 
你 的 新 里 程 碑 已 经 成 功 创建 。 
要 查看 你 的 一 个 群 组 的 所 有 里 程 碑 列 表 ， 请 完成 以 下 步 又。 
(1) 在 页 面 右上 角 ， 点 击 你 的 用 户头 像 。 
(2) 在 左 侧 边栏 中 ， 点 击 Groups ( 群 组 )。 
(3) 在 群 组 列表 中 ， 点 击 你 想 要 查看 里 程 碑 的 群 组 名 称 。 
(4) 在 左 侧 边 栏 中 点 击 Milestones (HEM). 
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此 时 将 会 显示 该 群 组 所 有 里 程 碑 的 列表 (图 12-17). 








New Milestone 


二 To milestones 


Title Moon Child Due o o 
Fanum Date June 2015 
Required 
Su Mo Tu We Th Fr Sa 
Description write Preview «" Edit in fullscreen Y 2 c9 7,4 6 8 


Bastian must save Fantasia! 























28 29 30 
Mi h GitLab Flavored Markdown. 
At dropping or selecting them. 
Create milestone Cancel 
N c 
12-16: 你 可 以 为 你 的 项 目 创建 基于 日 期 的 里 程 碑 
Milestones 2 milestones 
Only milestones from neverending-story group are listed here. 
9 Open @ Closed  AII 
Pass the Three Gates | o one | 
0 lssues 0 Merge Requests. 100% complete Ac 
southem-oracle 
Moon Child | Giose Milestone | 
Qissues O Merge Requests 100% complete ED 
sea-of-possibllities 











图 12-17; 指定 群 组 中 所 有 里 程 碑 的 列表 


12.7 小结 


GitLab 是 一 个 强大 的 开源 代码 托管 系统 ， 该 系统 的 功能 完全 可 以 与 GitHub 和 Bitbucket 提 
供 的 功能 相 媲 美 。 你 可 以 在 你 自己 的 网 络 中 安装 GitLab。 


。 可 以 为 每 个 仓库 〈 可 见 性 设置 )、 每 个 账户 〈 和 角色 设置 ) 和 每 个 分 支 (分支 保护 ) BOE 
义 访问 控制 。 

。 你 可 以 将 项 目 (CE) 和 用 户 收集 到 群 组 ， 实 现 更 方便 的 管理 。 

。 如 果 你 不 希望 自己 维护 软件 ,GitLab 同样 在 GitLab.com 提供 了 一 个 免费 的 云端 托管 服务 。 
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附录 人 


奶油 塔 





在 Git 中 ,分支 用 于 维护 代码 中 的 变化 。 这 些 变 化 可 能 是 正在 进行 的 工作 ， 也 可 能 是 一 个 
完全 不 同 的 方向 。 这 些 分 支 看 上 去 很 像 家 庭 食谱 的 不 同 变种 。 本 附录 包括 我 家 的 一 款 经 典 
加 拿 大 甜点 奶油 塔 (https://en.wikipedia.org/wiki/Butter tart) 的 两 个 食谱 变种 。( 加 拿 大 以 
外 的 人 看 到 这 里 ， 会 对 这 个 甜点 的 馅 料 产生 和 争议。 这 有 点 像 变 基 ， 但 是 更 糟 。) 


A.1 _ Austin 的 奶油 塔 


这 是 我 母亲 的 食谱 ， 是 从 她 的 祖母 Granny Austin 那里 传 下 来 的 。 该 食谱 中 一 向 只 添加 黑 
加 仓 ， 而 不 添加 任何 其 他 馅 料 。 
面皮 
。 两 杯 半 面 粉 
。 一 杯 起 酥油 
。 一 撮 盐 
。 冰 水 (足以 混合 ) 
(D) 将 起 酥油 切 碎 ， 加 入 面粉 中 。 
(2) 添 加 冰 水 (大约 半 杯 )。 
(3) 用 又 子 搅拌 。 
(4) 铺 开 。 
(5) 在 盛 松 饼 的 托 儿 中 截 几 个 洞 ， 不 要 填 满 ，450” F 烘焙 12 分 钟 。 
内 馅 
。 一 杯 糖 





























233 


。 半 杯 软化 黄油 
。 三 个 鸡蛋 
。 两 汤匙 甜 奶 油 或 酸奶 油 

(1) 混合 内 馅 材料 。 

D 在 填充 了 面皮 的 松 饼 托 上 ，400” 了 烘焙 25 分 钟 。 


A.2 van der Heyden 的 奶油 塔 


这 是 我 伯母 的 食谱 ， 是 从 她 的 母亲 Pat van der Heyden 那里 传 下 来 的 。 通 常 不 需要 另外 添加 
什么 ， 但 可 以 加 一 些 烘 烤 的 碎 果 仁 、 巧 克 力 脆 片 或 葡萄 干 。 























内 馅 

。 三 分 之 二 杯 软化 黄油 
。 三 杯 红糖 

。 三 杯 玉米 糖浆 

“十 二 个 鸡蛋 





混合 黄油 和 糖 。 先 添加 玉米 糖浆 ， 然 后 添加 鸡蛋 。 搅 拌 。 使 用 你 最 喜欢 的 面皮 配方 ， 铺 平 
后 切 成 蛋 拓 合适 的 大 小 ， 就 像 一 个 松 饼 托 的 形状 。 用 又 子 在 每 个 面皮 底部 稚 儿 个 洞 。 寒 入 
奶油 塔 的 内 馅 。 在 400° F 下 烘焙 21 分 钟 (左右 )。 

可 选择 性 添加 的 食材 包括 以 下 这 些 。 


。 烘 烤 的 碎 果 仁 

。 巧克力 脆 片 

。 葡萄 干 

面皮 

。 六 杯 普 通 面粉 

。 三 杯 起 酥油 (Karin 会 用 Crisco 起 酥油 ， 而 她 母亲 则 用 猪 油 ) 

。 两 个 鸡蛋 

。 一 点 醋 加 上 两 杯 冰 水 

用 起 酥油 混合 面粉 ， 使 之 结 块 。 打 和 蛋 ， 加 醋 和 水 。 不 断 向 干燥 的 面粉 加 水 直到 稳定 。 把 没 
用 完 的 面皮 装 在 塑料 盒子 里 冷冻 供 下 次 使 用 。 
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附录 日 


安装 最 新 版 本 的 Git 








本 书 主 要 介绍 Git 的 基础 知识 ， 如 果 不 升 级 Git， 你 会 遗漏 很 多 新 的 功能 。 一 般 来 说 ， 我 认 
为 新 版 本 的 软件 更 易于 使 用 。 错 误 说 明 更 加 清晰 ， 并 提供 了 更 好 的 “下 一 步 操作 ”建议 。 
一 些 复杂 的 命令 格式 得 以 改进 ， 使 得 命令 更 加 易于 使 用 。( 例 如 ， 使 用 --delete 参数 删除 
远程 分 支 的 能 力 ， 而 不 是 使 用 冒号 这 种 奇怪 的 格式 。) 

你 觉得 自己 已 经 安装 了 Git, (UI 


但 你 的 操作 系统 自 带 的 版 本 十 有 八 九 是 过 时 的 。“ 对 我 来 说 都 一 样 ”"， 我 听 到 你 这 么 说 了 。 
我 知道 ， 我 知道 。 我 曾经 也 是 这 么 想 的 :Git 那么 陈旧 复杂 ， 几 百 万 年 没 变 过 了 吧 ， 直 到 
我 去 参加 一 个 Gt 开发 者 会 议 。 在 会 议 中 ， 我 遇 到 了 很 多 热情 友好 、 耐 心 有 趣 并 积极 改进 
Git 的 开发 者 。 在 那 时 ，Git 的 维护 者 是 Junio Hamano, mi Windows 的 维护 者 是 Johannes 
Schindelin。 他 们 都 在 会 议 现场 ， 并 且 真 心 希望 让 Git 更 易于 用 户 使 用 。 如 果 你 不 安装 最 新 
版 本 ， 就 看 不 到 社区 快速 的 发 展 。 


你 应 该 总 是 试 着 使 用 最 新 版 本 的 软件 ， 而 且 必 须 确 认 你 至 少 在 使 用 2.5 以 上 版 本 的 Git。 在 
这 个 版 本 的 Git 中 ，git help 命令 好 用 多 了 。 我 对 这 个 改进 非常 激动 ， 因 为 这 是 我 初 识 Git 
时 困扰 我 很 久 的 事情 。 然 后， 在 Git 开发 者 大 会 上 ， 我 不 经 意 间 的 评论 最 后 变 成 了 一 个 非 
正式 的 bug 报告 ……: JLA HJE Sébastien Guimmara 和 Eric Sunshine 将 我 的 愿望 变 成 了 你 们 
可 以 使 用 的 命令 。 这 真是 难以 置信 |! 

我 通常 只 会 落后 几 个 补丁 版 本 〈 例 如 ， 如 果 最 新 版 本 是 2.5.2， 我 或 许 用 的 是 2.5.0), 但 
我 确实 会 留意 保持 相对 最 新 。 如 果 你 不 记得 最 近 几 个 月 安装 过 Git， 那 么 几乎 肯定 需要 升 
级 了 。 如 果 你 的 系统 中 还 没有 Git， 那 么 你 还 需要 安装 它 ( 这 很 简单 ! 你 可 以 使 用 安装 程 
Hl). 
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B.1 安装 和 升级 Git 

在 Windows 和 OS X 下 都 有 人 性 化 的 Git 安装 程序 。 一 般 来 说 ， 安 装 程序 会 在 你 升级 Git 
时 试图 保持 你 的 设置 不 变 。 

安装 程序 可 以 从 下 面 的 网 页 下 载 : 

http://git-scm.com/downloads 


如 果 你 使 用 Linux 或 Unix 系统 ， 那 么 可 能 已 经 安装 了 Git， 但 应 该 升级 到 最 新 版 本 。 使 用 
你 的 包 管理 工具 来 完成 这 一 步 ( 见 使 用 包 管 理工 具 来 安 
装 并 更 新 Git。 





























这 本 书 的 重点 是 介绍 从 命令 行使 用 Git。 对 此 我 一 点 都 不 后 悔 。 出 于 以 下 两 个 关键 的 原因 
我 认为 你 应 该 尝试 一 下 从 命令 行使 用 Git, 


(1) 当 所 有 人 都 在 命令 行 工作 时 ， 复 制 粘贴 所 有 操作 系统 中 可 用 的 文档 更 加 容易 。 

D 当 你 在 命令 行 工作 时 ， 会 获得 更 好 的 错误 消息 。 在 图 形 化 界面 上 ， 你 很 难 复制 粘贴 你 在 
遇 到 麻烦 之 前 运行 的 一 系列 命令 。 通 过 在 命令 行 中 工作 ， 你 将 能 够 在 出 错时 更 快 地 获得 
别人 的 帮助 。 


如 果 你 喜欢 图 形 化 界面 ， 那 么 随 着 你 渐渐 熟悉 本 书 中 的 概念 ， 我 建议 你 将 知识 迁移 到 图 形 
化 界面 上 。 









































B.2.1 OSX 

(D) 打开 Spotlight, Spotlight 可 以 在 菜单 栏 右上 角 的 放大 镜 或 按 下 Control+ 空格 找到 。 

(2) 在 Spotlight 的 搜索 框 中 键入 terminal， 然 后 按 下 回 车 。 一 个 新 的 命令 行 窗口 将 会 出 现 。 
B.2.2 Linux 


命令 行 窗口 的 位 置 将 会 根据 你 使 用 的 Linux 发 行 版 和 你 使 用 的 窗口 管理 器 而 有 所 不 同 ， 如 
果 你 不 知道 如 何在 你 的 Linux 版 本 中 打开 命令 行 窗 口 ， 使 用 你 熟悉 的 搜索 引擎 应 该 就 能 很 
快 和 弄 明白 。 




















B.2.3 Windows 
你 使 用 的 方法 将 会 根据 正在 使 用 的 Windows 版 本 而 略 有 不 同 。 
针对 Windows 7 的 方法 如 下 所 示 。 


(D Adi "JP" del. 
CO) 选择 “应 用 程序 ”一 “附件 ”一 “命令 提示 符 "。 命 令 行 窗口 将 会 打开 。 


针对 Windows 8 的 方法 如 下 所 示 。 
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(1) 前往 “应 用 ”页 面 (手指 上 请 ， 或 使 用 鼠标 点 击 屏幕 下 方 的 下 箭头 )。 
(2) 通 过 背 动 或 向 右 滚动 ， 找 到 标题 为 “Windows 系统 ”的 分 组 。 
(3) 在 “Windows 系统 ”分 组 下 ， 按 下 或 点 击 “命令 提示 符 ”。 


B.3 在 *nix 系 统 上 升级 
包 管 理工 具 是 确保 你 在 系统 中 使 用 最 新 版 本 的 Git 的 绝 佳 方式 。 在 Linux 和 Unix 变种 上 ， 
你 将 会 使 用 之 前 安装 Git 时 用 过 的 同一 个 包 管理 工具 来 升级 Git. (E, Git 之 前 已 经 安装 
了 ， 你 可 能 需要 升级 一 下 )。 

Homebrew 是 OS X 下 的 一 个 包 管理 工具 


如 果 你 正在 使 用 OS X， 并 且 已 经 安装 了 Homebrew (http://brew.sh/)， 你 应 
该 使 用 这 个 包 管理 工具 来 更 新 Git, 





























在 使 用 包 管 理工 具 时 ， 你 需要 记得 保持 你 的 包 列 表 最 新 。 一 般 来 说 你 可 以 通过 包 管 理工 具 
的 子 命令 update 来 完成 更 新 。 例 如 ， 在 Ubuntu 上 我 会 使 用 apt-get update, fF Fedora 上 
我 会 使 用 yum check-update， 而 在 OS X 上 我 会 使 用 brew update, 
一 旦 包 列 表 更 新 后 ， 你 可 以 为 你 的 系统 安装 最 新 包 版 本 的 软件 。 这 通常 是 通过 子 命令 
install 或 upgrade 来 完成 的 。 
针对 OS X 的 安装 命令 如 下 所 示 。 
$ brew install git 
针对 Ubuntu 和 使 用 apt 的 Linux 发 行 版 的 安装 命令 如 下 所 示 。 
$ apt-get install git 
针对 Fedora 和 使 用 yun 的 Linux 发 行 版 的 安装 命令 如 下 所 示 。 

$ yum install git 
为 了 确保 你 的 包 是 最 新 的 ， 你 可 以 单独 或 按 需 更 新 它们 ( 例 B-1)。 这 通常 通过 子 命令 
upgrade 来 完成 ， 尽 管 如 果 更 新 的 包 可 用 ， 再 次 运行 install 命令 也 能 够 更 新 软件 。 












































谨慎 升级 
小 心 ! 包 管理 工具 绝 大 多 数 时 候 都 是 很 棒 的 ， 但 有 时 候 在 你 的 截止 期 限 前 更 
新 所 有 包 并 非 明智 的 选择 。 





Bj B-1 使 用 Brew FRE 
OSX 下 只 升级 Git， 如 下 所 示 。 


$ brew upgrade git 
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OS X 下 通过 Homebrew 升级 所 有 包 ， 如 下 所 示 。 


$ brew upgrade 


B.4 OS X 上 的 小 麻烦 


当 我 与 Git 社区 更 加 熟悉 的 时 候 ， 我 开始 使 用 自 定义 的 构建 而 不 是 安装 程序 ， 这 样 我 可 以 尝 

试 最 新 的 功能 和 更 新 的 文档 。 当 我 尝试 将 代码 推送 到 远程 仓库 时 ， 有 时 会 遇 到 下 面 的 错误 。 
git: 'credential-osxkeychain' is not a git command. See 'git --help'. 

出 于 一 些 原因 ， 我 的 环境 变量 与 我 的 预想 不 符 。 在 厌倦 了 一 遍 遍 的 尝试 之 后 ， 我 下 载 了 另 

一 份 钥匙 串 辅助 程序 ， 将 它 放 在 我 的 硬盘 上 的 已 知 位 置 。 

你 不 太 可 能 会 丢失 你 的 钥匙 串 

我 高 度 怀疑 你 需要 这 一 节 ， 这 对 我 来 说 是 一 个 为 未 来 准备 的 小 贴 土 ， 记 录 我 

之 前 是 如 何 解决 这 个 问题 的 。( 是 的 ， 我 把 自己 的 书 当 作 参考 。 我 写 下 重要 

的 东西 ， 这 样 就 不 需要 将 他 们 都 记 在 我 的 脑子 里 。) 



































首先 ， 验 证 你 在 全 局 的 Git 配置 文件 中 设置 好 了 正确 的 验证 工具 。 这 个 文件 位 于 目录 
~/.gitconfig 下 ， 应 该 包括 如 下 设置 。 


[credential] 
helper = osxkeychain 
useHttpPath - true 


如 果 你 在 配置 文件 中 看 不 到 这 些 ， 现 在 运行 以 下 命令 进行 设置 。 
$ git config --global credential.helper osxkeychain 
运行 以 下 命令 来 查看 问题 是 否 已 解决 。 
$ git credential-osxkeychain 
你 应 该 不 会 收 到 之 前 看 到 的 错误 消息 。 
如 果 你 还 是 再 次 看 到 了 错误 消息 ， 遵 循 以 下 指令 。 你 将 下 载 并 安装 另 一 份 osxkeychain 的 
辅助 程序 ， 如 下 所 示 。 


$ curl -s -0 http://github-media-downloads.s3.amazonaws.com/ 
osx/git-credential-osxkeychain 


调整 文件 权限 来 运行 这 个 程序 ， 如 下 所 示 。 

$ chmod u+x git-credential-osxkeychain 
将 这 个 辅助 程序 移动 到 Unix 程序 的 应 用 文件 夹 下 ， 这 个 程序 会 以 根 用 户 身份 运行 ， 所 以 
你 需要 输入 你 的 OS X 登录 密码 来 运行 这 个 命令 ， 如 下 所 示 。 


$ sudo mv git-credential-osxkeychain /usr/local/git/bin 
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现在 ， 当 你 运行 下 面 的 命令 时 ， 应 该 不 会 看 到 之 前 出 现 的 关于 命令 找 不 到 的 错误 。 


$ git credential-osxkeychain 











这 份 文档 是 从 “Mac OS X 上 的 Git 和 GitHub 新 手 设 置 指南 ”(http://burnedpixel.com/blog/ 
setting-up-git-and-github-on-your-mac/) 中 的 说 明 转 换 而 来 。Chris Chernoff， 如 果 你 看 到 了 
这 里 ， 谢 谢 你 ! 你 的 建议 帮助 我 节省 了 运行 自 定义 Git 构建 的 时 间 ， 想 要 将 本 书 更 新 的 分 
支 推送 到 Atlas 构建 服务 器 上 时 ， 不 用 每 次 都 输入 我 设置 的 42 位 字符 的 随机 密码 。 


B.5 在 命令 行 上 访问 Git 帮 助 

Git 提供 了 内 置 的 命令 行文 档 。 这 些 信息 可 以 通过 运行 以 下 命令 获得 。 
$ git help 

你 可 以 通过 指定 话题 名 称 阅 读 某 个 话题 的 所 有 文档 ， 如 下 所 示 。 
$ git help topic 


为 了 前 往 帮 助 页 面 ， 你 可 以 使 用 键盘 的 方向 键 来 上 下 滚动 ， 当 你 结束 文档 的 阅读 时 ， 按 q 
退出 。 


要 查看 所 有 话题 的 列表 ， 请 使 用 以 下 命令 。 
$ git help --all 
你 还 可 以 查看 Git 的 术语 词汇 表 ， 如 下 所 示 。 


$ git help glossary 
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附录 C 


本 站 Git 





随 着 时 间 的 增长 ， 你 会 发 现在 命令 行 中 帮助 你 使 用 Git 的 捷径 。 我 自己 发 现 ， 那 些 对 Git 
最 感到 诅 丧 的 人 往往 是 最 少 定 制 Git 的 人 。 在 使 用 Git 时 ， 你 将 会 设置 两 种 类 型 的 配置 项 : 
全 局 设置 ， 应 用 于 所 有 仓库 ， 本 地 设置 ， 只 应 用 于 当前 仓库 。 全 局 设置 的 例子 可 以 是 你 的 
名 字 ， 而 你 的 电子 邮件 可 能 根据 你 的 个 人 项 目 和 工作 项 目 配置 而 不 同 。 

全 局 设置 储存 在 ~/.gitconfig 文件 中 ， 而 本 地 设置 储存 在 你 正在 工作 的 仓库 中 的 .git/config 
文件 中 。 如 果 需 要 ， 你 始终 可 以 回去 编辑 你 的 设置 。 

你 可 以 查看 当前 设置 的 值 。 例 如 ， 例 C-1 向 你 展示 如 何 查看 我 的 名 字 。 

fj C-1 显示 一 个 设置 的 值 


$ git config --get user.name 
你 还 可 以 获得 当前 设置 过 的 所 有 值 的 列表 (l C-2) 。 
例 C-2 显示 所 有 当前 设置 过 的 所 有 配置 项 的 值 


$ git config --list 


所 有 变量 的 列表 可 以 从 config 的 命令 页 面 (http//git-scm.com/docs/git-config) 上 查询 到 。 
这 也 同样 可 以 通过 运行 下 面 这 个 命令 来 访问 。 


$ git help config 


C.1 表明 身份 


为 了 展现 自己 的 工作 ， 你 需要 告诉 Git 你 是 谁 。 我 们 会 在 全 局 储存 你 的 名 字 〈 例 C-3) 和 电 
子 邮件 (P C-4)。 因 为 这 是 一 个 全 局 设置 ， 所 以 你 不 需要 在 茶 个 特定 的 仓库 中 进行 更 改 。 
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例 C-3 配置 你 的 名 字 


$ git config --global user.name 'Your Name' 


例 C-4 配置 你 的 电子 邮件 地 址 


$ git config --global user.email 'me(eexample.com' 


在 某 些 仓库 中 使 用 特定 的 电子 邮件 地 址 是 适当 的 〈 例 如 ， 如 果 你 进行 的 是 个 人 项 目 )。 你 
可 以 通过 完成 以 下 步 又， 指明 应 该 仅 将 这 些 更 改 应 用 于 特定 仓库 。 


(1) 前 往 拥有 想 要 配置 的 仓库 的 目录 。 
(2) 用 --local 替换 --global， 然 后 应 用 配置 命令 。 


示例 如 下 所 示 。 


$ git config --local user.email 'me(Wwork.com' 


EB —. V. r1 
C.2 更 改 提交 说 明 编 辑 器 
默认 情况 下 ，Git 会 使 用 系统 编辑 器 。 在 OS X 和 Linux 上 ， 一 般 这 是 Vim。 我 非常 喜欢 Vim 
而 且 这 也 是 我 使 用 的 编辑 器 。 它 有 一 些 难以 驾驭 ， 因 此 你 可 能 会 希望 更 改 你 的 编辑 器 。 
通过 运行 以 下 命令 查看 Git 当前 使 用 的 编辑 器 。 


$ git config --get core.editor 























你 必须 先 退 出 再 提交 
在 你 退出 编辑 器 后 提交 才 会 储存 到 Git， 而 不 只 是 保存 提交 说 明 。 这 可 能 会 
影响 你 对 文本 编辑 器 的 选择 。 











如 果 你 要 使 用 Textmate， 请 使 用 以 下 命令 。 

$ git config --global core.editor mate -w 
如 果 你 要 使 用 Subline， 请 使 用 以 下 命令 。 

$ git config --global core.editor subl -n -w 


如 果 你 想 要 更 改 Windows 的 编辑 器 ， 则 需要 加 入 应 用 文件 的 完整 路 径 。 应 用 通常 安装 在 
目录 C:\Program Files 下 ， 你 需要 在 路 径 两 侧 加 上 双 引 号 。 此 外 ， 每 当 你 使 用 Bash 来 调用 
git config 时 ， 必 须 给 值 加 上 引号 ， 这 会 导致 出 现 了 一 个 双重 引号 的 字符 串 ， 如 下 所 示 。 


$ git config --global core.editor '"C:\Program FilesVVimMgvim.exe" --nofork' 


至 于 其 他 编辑 器 ， 请 查看 你 选择 的 编辑 器 的 配置 说 明 。 


C.3 添加 颜色 


阅读 大 有 段 文本 是 很 费劲 的 。 可 以 在 命令 行 中 添加 辅助 颜色 ， 以 便 更 容易 看 清楚 Git 在 做 什 
么 ， 如 下 所 示 。 

















$ git config --global color.ui true 
$ git config --global diff.ui auto 


C.4 自 定 义 命 令 提 示 符 

如 果 你 在 命令 行 中 工作 ， 那 么 在 明确 询问 Git 之 前 ， 你 对 文件 中 发 生 了 什么 是 毫 无 线索 的 。 
不 断 地 询问 是 非常 令 人 厌烦 的 。 就 好 像 你 在 八 岁 的 时 候 坐 在 车 后 座 ， 不 断 地 向 司机 发 牢骚 
“我 们 快 到 了 吗 ”。 

代 禁 明确 询问 的 是 ， 我 修改 了 命令 提示 符 ， 让 它 告 诉 我 当前 签 出 的 分 支 ， 以 及 我 是 否 修改 
了 仓库 中 的 任何 文件 ， 这 是 一 个 很 常见 的 小 技巧 ， 但 每 个 开发 者 都 有 自己 的 实现 方式 。 上 
网 搜索 “bash prompt git status” 将 会 返回 大 量 结 果 。 我 自己 的 提示 符 非常 简单 ， 但 其 他 人 
在 他 们 的 提示 符 中 添加 了 很 多 细节 。 例 如 : 在 命令 提示 符 中 显示 〈 带 颜色 的 ) Git 状态 和 
4y X (https://git-scm.com/docs/git-config) 或 本 地 文件 状态 (https://github.com/magicmonty/ 
bash-git-prompt) 。 与 所 有 技术 一 样 ， 你 一 开始 添加 的 东西 越 多 ， 那 么 它 出 错 后 你 需要 解决 
的 bug 就 越 多 。 

我 发 现 这 些 华丽 的 提示 符 很 难 设 置 ， 最 终 变 成 一 个 非常 复杂 的 提示 符 。 我 推荐 从 简单 的 开 
始 ， 然 后 如 果 你 真 的 想 要 更 多 信息 ， 再 往 上 添加 。 颜 色 上 的 简单 变化 以 及 分 支 的 名 称 ， 事 
实 上 对 我 来 说 已 经 足够 了 ， 去 掉 所 有 额外 信息 会 显得 更 加 清爽 。 


C.5 忽略 系统 文件 


我 们 都 曾 遇 到 过 : 不 小 心地 暂 存 了 OS X 的 .DS Store 系统 文件 或 者 文本 编辑 器 的 临 
时 swp 文件 。 你 可 以 通过 设置 一 个 全 局 忽略 文件 来 减少 蓝 雁 ， 让 Git 避免 将 这 些 文件 提 
交 到 任何 你 创建 的 本 地 仓库 。 可 以 找到 忽略 文件 的 详细 清单 (https//github.com/github/ 
gitignore) 。 挑 选 最 适合 你 的 系统 和 项 目的 列表 。 
一 旦 你 选 好 了 想 要 忽略 的 文件 列表 ， 请 完成 以 下 步骤 。 
(1) 创建 一 个 新 的 文本 文件 ， 名 为 .gitignore_global， 将 它 放 在 你 的 home 目录 下 。 
(2) 通过 运行 以 下 命令 告诉 Git 使 用 这 个 配置 文件 。 
$ git config --global core.excludesfile -/.gitignore global 

你 或 许 还 有 特定 项 目 中 的 文件 或 者 甚至 是 输出 目录 〈 例 如 构建 文件 夹 ) 不 想 提交 到 仓库 。 
在 每 个 仓库 中 ， 你 都 可 以 创建 一 个 自 定义 的 “忽略 ”文件 ， 进 一 步 限 制 Git 要 跟踪 的 文件 
步骤 如 下 。 
(D 创建 一 个 新 的 文本 文件 ， 名 为 .gitignore， 将 它 放 在 你 的 项 目 根 目录 下 。 
D 在 这 个 文件 中 添加 所 有 你 希望 Git 永远 不 要 添加 到 仓库 的 文件 名 称 ， 每 个 文件 名 应 该 单 

独 一 行 。 你 也 可 以 使 用 模式 匹配 ， 例 如 *.swp 代表 临时 的 编辑 器 文件 。 
这 个 更 改 需要 在 Git 仓库 中 创建 一 个 新 提交 ， 如 下 所 示 。 


$ git add .gitignore 
$ git commit -m "Adding list of files to be ignored." 
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如 果 你 在 跨 平 台 的 团队 中 工作 ， 开 发 者 分 别 使 用 OS X, Linux 和 Windows， 那 么 本 节 尤 其 
重要 。 
你 应 该 在 全 局 设置 这 个 行 结束 符 ， 但 同时 在 每 个 仓库 中 添加 这 个 设置 ， 从 而 确保 没有 显 式 
设置 行 结束 符 的 开发 者 不 会 遇 到 问题 ， 如 下 所 示 。 

$ git config --global core.autocrlf input 
为 了 明确 地 让 所 有 贡献 者 使 用 正确 的 行 结束 符 ， 你 需要 在 你 的 仓库 中 添加 一 个 .gitattributes 
文件 ， 标 记 正确 的 行 结束 符 、 应 该 被 改正 的 文本 文件 和 不 应 该 被 修改 的 二 进 制 文件 。 
在 仓库 根 目录 (与 .git 位 于 同一 文件 夹 中 ) 下 创建 一 个 名 为 .gitattributes 的 新 文本 文件 。 新 
文件 的 样 例如 下 所 示 。 

# 设置 所 有 文件 的 默认 行为 


* text-auto 
































# 列 出 应 使 用 系统 相关 的 行 结束 符 的 文本 文件 
*.php text 
*.html text 
*.css text 


# 列 出 应 使 用 CRLF 行 结束 符 且 不 根据 本 地 操作 系统 转换 的 文件 


.SLn text eol=crlf 


* 

















列 出 所 有 不 应 进行 修改 的 二 进 制 文件 


# 
*.png binary 
* 
* 
* 





.jpg binary 
.gif binary 
.ico binary 


将 文件 添加 到 和 暂 存 区 索引 ， 如 下 所 示 。 
$ git add .gitattributes 
将 文件 提交 到 仓库 ， 如 下 所 示 。 


$ git commit -m "Require the right line endings for everyone, forever." 


修复 行 结束 符 
如 果 你 不 幸 在 项 目 中 期 需要 统一 行 结束 符 ， 则 需要 完成 以 下 步 又 。 


(有) 与 你 的 团队 一 起 决定 你 的 仓库 中 使 用 的 “官方 ” 行 结束 符 。 

(2) 变 基 每 个 受 影 响 的 文件 来 重 置 行 结束 符 。 如 果 是 我 的 朋友 ， 她 会 使 用 Vim 并 设置 :set 
ff=unix。 你 可 能 更 喜欢 在 你 的 文本 编辑 器 中 打开 每 个 文件 并 重新 保存 每 个 文件 来 重 置 
行 结束 符 ， 或 者 使 用 dos2unix 这 样 的 命令 行 工具 。 

(3) 将 更 新 的 文件 添加 并 提交 到 仓库 。 

(4) 如 上 节 所 述 的 那样 将 .gitattributes 文件 添加 到 你 的 仓库 。 






























































(5) 将 更 改 推送 到 代码 托管 服务 器 。 





(6) 要 求 团队 中 其 他 人 使 用 rebase 命令 更 新 他 们 的 工作 ， 这 样 “不 好 的 ” 行 结束 符 不 会 





被 意外 地 引入 仓库 了 。 
(7) 喝 一 杯 热 巧克力 或 威士忌 。 这 是 你 应 得 的 。 
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使 用 了 SSH 密 钥 之 后 ， 在 你 连接 到 远程 机 器 时 就 不 需要 每 次 输入 密码 。 密 钥 本 身 是 成 对 出 
现 的 : 一 个 公 钥 和 一 个 私 钥 。 应 该 将 私 钥 当 作 密 码 对 待 ， 且 永远 不 应 该 与 别人 共享 。 公 铀 
将 会 被 “安装 ”在 其 他 地 方 ， 例 如 代码 托管 系统 中 。 


D.1 创建 你 自己 的 SSH 密 钥 


要 想 创建 一 个 SSH 密 钥 ， 你 需要 运行 一 个 程序 ， 它 会 保存 一 对 文件 。 这 个 必需 的 软件 已 安 
装 在 *nix 系统 上 ， 而 Windows 用 户 需 要 额外 (免费 ) 下 载 这 个 软件 。 











D.1.1 Linux、OS X 和 Unix 变 种 
为 了 生成 一 对 密 钥 ， 你 需要 运行 以 下 命令 。 
$ ssh-keygen -t rsa -b 4096 -C "your. emailgexample.com" 


系统 将 提示 你 输入 以 下 信息 。 





。 文件 位 置 
通过 按 下 回 车 接受 默认 位 置 以 继续 。 
。 密码 





可 选项 。 但 你 真 的 应 该 设置 一 个 。 使 用 容易 记忆 的 密码 或 者 将 它 放 在 你 日 常 使 用 的 非常 
安全 的 密码 管理 器 中 。 


密 钥 的 指纹 将 会 输出 到 屏幕 上 ， 且 这 个 密 钥 对 将 会 被 保存 到 合适 的 位 置 ~/.ssh/。 
现在 ， 你 需要 在 系统 中 注册 这 个 密 钥 ， 才 能 开始 使 用 它 。 
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此 时 事情 变 得 有 些 神秘 。 你 需要 在 本 地 “代理 ”中 注册 你 的 密 钥 (在 用 OS X? 想象 一 下 
钥匙 串 ”， ie FE). Rie Ri a 如 下 所 示 。 


$ eval "S(ssh-agent -s)" 
使 用 代理 注册 SSH 密 钥 ， 如 下 所 示 。 
$ ssh-add -/.ssh/id rsa 
你 的 密 钥 已 经 注册 。 
如 果 你 需要 立即 使 用 这 个 密 钥 ， 请 直接 跳 到 D.2 节 。 





























D.1.2 Windows 
在 Windows 下 生成 一 个 SSH 密 钥 对 (需要 用 到 PuTTYgen 软件 ) 的 操作 步骤 如 下 所 示 。 


(1) 4E PuTTYgen 下 载 页 面 (http//www.chiark.greenend.org.uk/-sgtatham/putty/download.html ) 

上 找到 PuTTYgen 的 最 新 版 本 。 文 件 名 为 puttygen.exe。 

(2) 右 键 点 击 puttygen.exe 的 链接 ， 选 择 “ 将 链接 另存 为 "。 具 体 文字 可 能 根据 你 的 浏览 器 

而 略 有 不 同 。 

(3) 出 现 弹 出 窗口 后 ， 选 择 一 个 你 能 够 轻易 找到 的 目录 (例如 ， 你 的 桌面 目录 )。 

(4) 找到 桌面 上 的 PuTTYgen 应 用 。 双 击 图 标 运 行 这 个 程序 。 

(5) 在 窗 体 底部 的 Type of key to generate. (生成 的 密 钥 类 型 ) 中 选择 SSH-2 RSA., 

(6) 找到 并 点 击 Generate (生成 ) 按钮 。 

C) 摇摆 你 的 鼠标 。 我 是 认真 的 。 你 将 会 制造 出 随机 数据 (噪声)， 这 有 助 于 密 钥 生成 的 过 
程 。 继 续 操 作 ， 直到 进度 条 全 部 充满 

(8) 系统 将 提示 你 输入 密码 。 这 是 可 选 的 ， 但 你 应 该 添加 一 个 

(9) 找到 并 点 击 Save private key (保存 私 钥 ) 。 

(10) 找到 并 点 击 Save public key (保存 公 钥 ) 。 


这 样 应 该 会 将 密 钥 保 存 到 目录 ~/.ssh/ 下 的 某 个 合适 位 置 。 
如 果 你 准备 好 立即 使 用 SSH 密 钥 ， 请 同样 完成 以 下 几 步 。 


(D 找到 标题 Public key for pasting into OpenSSH authorized keys file (粘贴 到 OpenSSH 的 
authorized keys 文件 中 的 公 钥 )。 

O 右键 点 击 标题 下 方 的 随机 字符 串 。 

(3) 选 择 Select all (全 选 )， 然 后 选择 Copy (复制 )。 


你 的 公 钥 已 经 被 复制 到 剪贴 板 上 。 你 可 以 进行 下 一 步 。 


D.2 ”获得 你 的 SSH 公 铀 


当 你 的 代码 托管 系统 向 你 询问 “SSH 公 钥 ”时 ， 它 需要 id_rsa.pub 文件 中 的 内 容 。 这 个 文 
件 通常 储存 在 home 目录 下 的 一 个 隐藏 文件 夹 中 : .ssn。 要 找到 这 个 文件 ， 并 将 它 的 内 容 复 
制 到 剪贴 板 ， 根 据 你 的 操作 系统 ， 你 需要 完成 下 述 命令 。 通 过 在 命令 行 中 工作 ， 你 可 以 避 
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免 寻找 一 个 能 识别 出 pub 文件 的 编辑 器 。 它 只 是 文本 ， 但 你 安装 的 文本 编辑 器 可 能 并 不 知 

道 这 一 点 。 

在 OSX 下 的 操作 步骤 如 下 所 示 。 

(D 打开 命令 行 窗口 。 

(2) 运行 下 列 指令 : cat -/.ssh/id rsa.pub | pbcopy。 

在 Linux 下 的 操作 步骤 如 下 所 示 。 

(D 打开 命令 行 窗口 。 

(0) 运行 下 列 指令 : cat ~/.ssh/id_rsa.pub。 此 时 应 该 会 在 屏幕 上 输出 一 个 非常 长 的 字符 
串 ， 它 应 该 与 命令 行 窗 口 等 宽 ， 并 且 不 包含 单词 PRIVATE KEY。 如 果 找 不 到 文件 ， 你 
需要 首先 创建 一 个 SSH 密 钥 。 

G) 复制 在 屏幕 上 输出 的 所 有 文本 。 

在 Windows 下 的 操作 步骤 如 下 所 示 。 

(1) 打 开 Git Bash 窗口 。 

(2) 运行 下 列 命令 : clip < ~/.ssh/id_rsa.pub。 它 会 将 你 的 SSH 公 铀 复制 到 剪贴 板 。 

你 的 SSH 公 钥 现在 复制 到 剪贴 板 了 ， 你 可 以 将 它 粘贴 到 你 选择 的 代码 托管 系统 的 设置 页 

面 中 。 
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Emma 提倡 通过 动手 创新 性 地 参与 技术 ， 她 还 是 一 个 业余 的 养 蜂 人 。 你 可 以 在 Twitter EX 
注 她 ， 她 的 Twitter 账号 是 @emmajanehw。 


天 于 封面 
A PH ntad X € d$ 4$ (Motacilla alba), Æ 4$ 4$ (Motacilla cinerea) f- 3 4 46 
(Motacilla flava) , 


Motacilla 属 的 名 字 意 为 “移动 尾巴 >",， 正如 它们 的 名 字 所 有 瞳 示 的 ， 这 些小 巧 而 精力 充沛 的 
鸟 因为 经 常 上 下 户 动 它们 的 长 尾巴 而 被 人 所 熟知 。 但 这 种 行为 的 原因 尚 不 明确 。 平 均 来 
说 ， 这 些 鸟 身 长 约 6 英寸 ， 重 约 0.8 蔓 司 。 

忽忽 靠 捕 食 小 昆虫 为 生 ,， 偶尔 在 附近 的 牛 群 中 疯 食 ， 捕 扣 干 扰 牛 群 的 昆虫 。 它 们 也 在 地 面 
JE : > :次 下 4-7 T^. 

澳 岛 分 布 广泛 ， 繁 殖 于 整个 欧 亚 地 区 ， 有 时 还 迁徙 到 非洲 的 热带 地 区 。 它 们 喜欢 开阔 的 乡 
野 ， 如 农场 和 草地 。 然 而 ， 近 年 来 这 三 个 物种 的 数量 都 遭遇 了 严重 的 下 滑 ， 可 能 是 由 于 农 
业 的 变化 导致 的 。 

O'Reilly 封面 上 的 很 多 动物 都 已 经 濒危 ， 每 一 种 动物 对 我 们 的 世界 都 很 重要 。 要 了 解 更 多 
有 关 如 何 提供 帮助 的 信息 ， 请 访问 网 页 http://www.oreilly.com/animals.csp。 








该 封面 图 片 取材 自 Woods Illustrated Natural History, 
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Git 团 队 协 作 


Git 不 仅 是 协助 软件 开发 的 利器 ， 还 是 高 效 团队 管理 的 秘密 武器 。 曾 在 全 
球 上 百 场 会 议 中 分 享 过 Git 精 神 的 Emma， 将 在 本 书 中 与 读者 分 享 自己 多 
年 来 在 开发 和 项 目 管理 中 利用 Git 技 能 所 得 到 的 丰富 经 验 。 


书 中 内 容 共 分 为 三 部 分 。 第 一 部 分 介绍 工作 流 的 构建 ， 从 宏观 视角 陈述 
以 不 同方 式 组 织 工 作 流 会 如 何 影 响 团 队 协 作 方式 。 第 二 部 分 分 别针 对 单 
人 团队 和 多 人 团队 ， 从 实践 角度 阐述 Git 命 令 ， 提供 上 手 练习 。 第 三 部 分 
介绍 主流 代码 托管 系统 ， 为 读者 提供 这 些 平 合 用 法 的 入 门 指 南 。 


m 探索 团队 构建 的 奥秘 

m 研究 使 用 Git 创 造 和 部 署 软件 的 流程 

m 构建 工作 流 来 影响 团队 的 协作 方式 

m 了 解 实施 代码 评审 的 实用 流程 

m 建立 共享 仓库 ， 将 特定 的 团队 成 员 看 作 贡 献 者 、 消 费 者 或 维护 者 
m 了 解 团队 成 员 使 用 Git 命 令 背后 的 原因 

m 使 用 分 支 策略 来 分 隔 项 目 中 不 同 的 工作 

m 了 解 三 个 主流 协作 平台 的 用 法 : GitHub、Bitbucket 和 GitLab 





Emma Jane Hogbin Westby， 资 深 Web 开 发 人 员 ， 并 拥有 丰富 的 团队 管理 
经 验 ， 曾 在 全 球 举办 过 100 多 场 会 议 演讲 、 课 程 和 研讨 会 ， 内 容 涉 及 Web 
前 端 开 发 、 无 障碍 标准 、 分 布 式 版 本 控制 、 可 视 化 和 变更 管理 。Twitter 账 


5: @emmajanehw。 
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